# session_set_cookie_params

(PHP 4, PHP 5, PHP 7)

session_set_cookie_params — 设置会话 cookie 参数

### 说明

session_set_cookie_params ( int `$lifetime` [, string `$path` [, string `$domain` [, bool `$secure` = `FALSE` [, bool `$httponly` = `FALSE` ]]]] ) : bool

Cookie 参数可以在 php.ini 文件中定义，本函数仅在当前脚本执行过程中有效。 因此，如果要通过函数修改 cookie 参数，需要对每个请求都要 在调用 session_start() 函数之前调用 session_set_cookie_params() 函数。

本函数会修改运行期 ini 设置值， 可以通过 ini_get() 函数获取这些值。

### 参数

`lifetime`

  Cookie 的 生命周期，以秒为单位。

`path`

  此 cookie 的有效 路径。 on the domain where 设置为“/”表示对于本域上所有的路径此 cookie 都可用。

`domain`

  Cookie 的作用 域。 例如：“www.php.net”。 如果要让 cookie 在所有的子域中都可用，此参数必须以点（.）开头，例如：“.php.net”。

`secure`

  设置为 `TRUE` 表示 cookie 仅在使用 安全 链接时可用。

`httponly`

  设置为 `TRUE` 表示 PHP 发送 cookie 的时候会使用 httponly 标记。

### 返回值

成功时返回 `TRUE`， 或者在失败时返回 `FALSE`。

### 更新日志

版本 | 说明
--- | ---
7.2.0 | 成功时返回 `TRUE`， 或者在失败时返回 `FALSE`。 之前版本中是返回 void 的。
5.2.0 | 加入 `httponly` 参数。

### 参见

- session.cookie_lifetime
- session.cookie_path
- session.cookie_domain
- session.cookie_secure
- session.cookie_httponly
- session_get_cookie_params() - 获取会话 cookie 参数