Yii2 默认将 session 文件存储在系统临时目录（如 /tmp），但可通过配置灵活指定本地路径或切换为数据库存储，本文详解其原理、查看方式与实战配置。
yii2 默认将 session 文件存储在系统临时目录（如 `/tmp`），但可通过配置灵活指定本地路径或切换为数据库存储，本文详解其原理、查看方式与实战配置。
在 Yii2 应用中，session 数据的物理存储位置由 PHP 的底层会话机制决定，Yii2 本身不直接管理文件写入，而是通过 yii\web\Session 组件封装并委托给 PHP 的 session_save_path() 函数处理。默认情况下，该路径为 '/tmp'（Linux/macOS）或系统环境变量指定的临时目录（Windows 下通常为 C:\Windows\Temp）。你可以在源码中确认这一默认值：yii2/framework/web/Session.php#L364 明确声明了 $savePath 属性的默认值。
你可以通过以下方式动态获取当前生效的 session 存储路径：
echo Yii::$app->session->getSavePath(); // 输出示例：/var/tmp 或 /Applications/XAMPP/xamppfiles/temp
⚠️ 注意：实际路径可能受多层配置影响，优先级从高到低为：Yii2 配置 → .htaccess（Apache）→ php.ini 中的 session.save_path。例如，在 XAMPP 环境中，若 php.ini 设置为 session.save_path="/Applications/XAMPP/xamppfiles/temp"，则 Yii2 未显式配置时即沿用此路径。
自定义文件存储路径（推荐用于开发/轻量部署）
在 config/web.php 的 components 配置块中显式指定 savePath，即可覆盖默认行为。路径建议使用绝对路径，并确保 Web 服务器进程（如 Apache 的 www-data 或 Nginx 的 nginx 用户）拥有读写权限：
'components' => [
'session' => [
'class' => 'yii\web\Session',
'name' => '_MyAppSession', // 可选：自定义 Cookie 名称
'savePath' => dirname(__DIR__) . '/runtime/sessions', // 推荐：使用 Yii2 runtime 目录
'timeout' => 1800, // 30 分钟无操作后过期
'cookieParams' => ['httponly' => true, 'samesite' => 'Lax'],
],
],✅ 最佳实践：
- 使用 runtime/sessions（需确保 runtime/ 目录可写）而非系统 /tmp，便于项目隔离与部署一致性；
- 避免使用相对路径（如 './sessions'），防止因工作目录变化导致路径错误；
- 首次使用前手动创建目录并授权：mkdir -p runtime/sessions && chmod 755 runtime/sessions。
切换为数据库存储（适用于集群/高可用场景）
当应用部署于多服务器环境或需持久化 session 时，应改用 yii\web\DbSession。它将 session 数据存入数据库表（默认表名为 session），天然支持分布式共享。
首先，执行数据库迁移创建 session 表（以 MySQL 为例）：
CREATE TABLE `session` ( `id` CHAR(128) NOT NULL PRIMARY KEY, `expire` INTEGER, `data` TEXT, `created_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP, `updated_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
然后在配置中启用 DbSession：
'components' => [
'session' => [
'class' => 'yii\web\DbSession',
'db' => 'db', // 指向已配置的数据库组件 ID（默认为 'db'）
'sessionTable' => 'session', // 表名，可选
'timeout' => 86400, // 24 小时
'writeCallback' => function ($session) {
return [
'user_id' => Yii::$app->user->isGuest ? null : Yii::$app->user->id,
'ip_address' => Yii::$app->request->getUserIP(),
'user_agent' => Yii::$app->request->getUserAgent(),
];
},
],
],? writeCallback 允许你在写入 session 时注入额外字段（如用户 ID、IP），前提是数据库表结构已扩展对应列，并重写 DbSession::writeSession() 逻辑（需继承定制）。
总结
- 默认路径为 '/tmp'，但真实路径取决于 php.ini 和运行环境；
- 优先通过 Yii2 配置 savePath 实现可控、可移植的文件存储；
- 生产集群环境务必使用 DbSession 或 Redis（通过 yii\redis\Session）等共享存储；
- 始终验证目录权限与数据库表结构，避免因配置疏漏导致 session 丢失或登录异常。
