PHP Session 完整指南：从入门到配置

理解 Session 核心机制

PHP Session 旨在将用户提交的数据以全局变量形式保存在服务器端，同时为每个会话生成唯一的 session_id。同一浏览器访问同一站点时，通常只维持一个有效的 Session ID，从而避免数据混淆。

所有与 Session 相关的操作，必须首先调用 session_start() 函数启动会话。

第一步：初始化与会话变量赋值

在 PHP 4.2 版本之后，推荐使用超全局数组 $_SESSION 直接进行赋值和读取，旧的 session_register() 函数已被弃用。

1. 启动会话：在任何 HTML 输出或空白行之前，调用 session_start()。
2. 赋值变量：将需要保存的数据存入 $_SESSION 数组。

<?php
// 1. 必须先调用 start
session_start();

// 2. 直接使用 $_SESSION 数组赋值
$_SESSION["name"] = "这是一个Session例子";

// 验证赋值是否成功
echo $_SESSION["name"];
?>

第二步：读取与注销会话变量

通过访问 $_SESSION 数组即可读取已注册的变量。当不再需要保留特定数据或结束时整个会话时，需要进行注销操作。

1. 读取 Session 数据

读取方法与赋值相反，直接通过键名访问数组值：

<?php
session_start();
// 假设前面已注册 username
echo "登记的用户名为：" . $_SESSION["username"];
?&uot;

2. 注销单个变量

使用 unset() 函数可以安全地从 $_SESSION 中移除单个变量：

<?php
session_start();

// 注销指定变量
unset($_SESSION['age']);

// 此时 $_SESSION['age'] 将变为空或未定义
echo '年龄：' . $_SESSION['age']; // 输出为空
?>

3. 销毁整个 Session

若要彻底结束当前会话（例如用户登出），需按顺序执行以下操作：

1. 清空内容：使用 session_unset() 释放所有注册的全局变量集合。
2. 销毁标识：使用 session_destroy() 销毁存储在服务器端的 Session 数据文件。

<?php
session_start();
session_unset();   // 释放内存中的变量
session_destroy(); // 删除服务器上的 Session 文件
?>

第三步：配置 Session 生存期与保存路径

默认情况下，Session 会随着浏览器关闭而失效。根据业务需求，可以手动设置 Cookie 的生命周期及 Session 文件的保存目录。注意，涉及路径和参数的配置必须在 session_start() 调用之前完成。

1. 设置 Session 生存期 (Cookie 有效期)

由于 Session 依赖于 Cookie 传递 ID，可以通过 setcookie() 或 session_set_cookie_params() 来延长存活时间。

<?php
// 方案 A: 手动设置 Cookie 参数 (兼容性好)
$lifeTime = 24 * 3600; // 保存一天，单位秒
setcookie(session_name(), session_id(), time() + $lifeTime, "/");

// 方案 B: 使用内置函数 (推荐用于 PHP 5 以上)
// 必须在 session_start() 之前调用
// session_set_cookie_params($lifeTime);

session_start();
$_SESSION["admin"] = true;
?>

2. 自定义 Session 文件保存路径

为了防止 Session 文件被覆盖或便于管理，可以指定特定的目录：

<?php
// 必须在 session_start() 之前调用
$savePath = "./session_save_dir/";
$lifeTime = 24 * 3600;

// 设置保存路径
session_save_path($savePath); 
// 设置生存期
session_set_cookie_params($lifeTime);

session_start();
$_SESSION["admin"] = true;
?>

常见问题排错

1. Warning: Cannot modify header information

现象：如果在 session_start() 之前有任何输出（包括 HTML、空格、BOM 头），会导致报错 “Headers already sent”。

解决方法：

• 确保 session_start() 是脚本的第一条可执行语句。
• 检查文件开头是否有不可见的空白字符或 HTML 标签。
• 若无法确定位置，可使用缓冲区输出：
  <?php ob_start(); ?>

2. Open(/tmp/sess_...) failed

原因：服务器未指定默认的 Session 临时文件夹权限或路径不存在。

解决方法：

• 在服务器端创建相应的临时文件夹（如 /tmp）并确保其有写入权限。
• 修改 php.ini 配置文件，调整 session.save_path 指向有效路径。