如何使用 session_get_cookie_params 获取 PHP 会话的 cookie 配置

---

什么是 session_get_cookie_params()？

session_get_cookie_params() 是 PHP 内置的 Session 处理函数之一，它返回当前会话 cookie 的所有参数，以数组的形式呈现。返回值包含以下键值对：

• lifetime: cookie 的生命周期（以秒为单位）

• path: cookie 有效的路径

• domain: cookie 所在的域名

• secure: 是否只通过 HTTPS 传输

• httponly: 是否只能通过 HTTP 协议访问

这个函数通常与 session_set_cookie_params() 配合使用，在需要设置或获取会话 cookie 参数时非常方便。

示例代码

以下是一个基本的使用示例：

<code> <?php // 启动会话前获取默认的 cookie 设置 $params = session_get_cookie_params();

echo "Lifetime: " . $params["lifetime"] . "<br>";
echo "Path: " . $params["path"] . "<br>";
echo "Domain: " . $params["domain"] . "<br>";
echo "Secure: " . ($params["secure"] ? "true" : "false") . "<br>";
echo "HttpOnly: " . ($params["httponly"] ? "true" : "false") . "<br>";
?>
</code>

执行结果将会显示出当前 PHP 会话 cookie 的全部参数。

与 session_set_cookie_params() 配合使用

你可以先通过 session_set_cookie_params() 自定义设置参数，然后再通过 session_get_cookie_params() 来验证是否设置成功：

<code> <?php // 自定义 cookie 参数 session_set_cookie_params([ 'lifetime' => 3600, 'path' => '/', 'domain' => 'gitbox.net', 'secure' => true, 'httponly' => true ]);

// 启动会话
session_start();

// 获取并显示参数
$params = session_get_cookie_params();
print_r($params);
?>
</code>

在以上代码中，我们自定义了一个会话 cookie 设置，确保该 cookie 只能通过 HTTPS 传输、不能被 JavaScript 访问，并且限定在 gitbox.net 域名下生效。随后我们通过 session_get_cookie_params() 输出验证配置是否正确。

使用场景

1. 调试配置问题
   开发过程中，你可能需要确认服务器的 session 设置是否正确，例如在不同环境（开发、测试、生产）下进行排查。

2. 安全性审核
   确保会话 cookie 被标记为 secure 和 HttpOnly，是防止中间人攻击和 XSS 攻击的基本要求。

3. 跨域应用优化
   当你的网站使用多个子域时（如 app.gitbox.net 和 api.gitbox.net），你可以通过设置 cookie 的 domain 值来实现子域间共享 session。

注意事项

• session_get_cookie_params() 必须在调用 session_start() 之前或之后都可以使用，但其返回的是“设置”值，而非某个特定客户端当前 cookie 的状态。

• 若需要兼容老版本 PHP，建议在设置参数时避免使用数组形式，使用旧式参数传递方式。