PHP session不生效，cookie配置检查

前言

PHP用session存用户登录状态，结果刷新页面就掉了？session不生效太常见了，一般就是cookie配置不对、路径不对、或者目录没权限。本文讲怎么排查和解决。

一、session工作原理

简单说：

1. 浏览器访问网站
2. PHP创建session，生成session_id
3. session_id通过cookie发给浏览器
4. 浏览器每次请求带上这个cookie
5. PHP根据cookie里的session_id找到对应数据

核心： session靠cookie传session_id，cookie不行session就没了。

二、常见原因

原因1：cookie没设置对

session.cookie_path、session.cookie_domain配置不对。

原因2：session保存目录没权限

session文件存不进去。

原因3：session.auto_start没开

或者开了但和代码冲突。

原因4：跨域问题

主域和子域之间cookie不共享。

原因5：HTTPS下cookie的secure问题

cookie设了secure，但用http访问。

三、排查步骤

第一步：检查session有没有启动

<?php
session_start();

// 存个值
$_SESSION['test'] = 'hello';

// 看有没有
echo '<pre>';
print_r($_SESSION);
echo '</pre>';

刷新页面，看test还在不在。

第二步：看cookie里有没有PHPSESSID

按F12打开浏览器开发者工具 → Application → Cookies。

看有没有 PHPSESSID 这个cookie。

没有的话： 就是cookie没设对。

有的话： 那就是session保存目录的问题。

四、php.ini配置检查

找到php.ini位置

php --ini

关键配置

;session保存目录
session.save_path = "/var/lib/php/session"

;是否自动启动
session.auto_start = 0

;cookie路径
session.cookie_path = /

;cookie域名
session.cookie_domain =

;cookie有效期（秒）
session.cookie_lifetime = 0

;是否仅https
session.cookie_secure = 0

;是否仅http（防XSS）
session.cookie_httponly = 1

五、常见坑和解决

坑1：session目录没权限

session文件写不进去。

检查：

ls -ld /var/lib/php/session

解决：

chmod 777 /var/lib/php/session
chown apache:apache /var/lib/php/session

或者看php-fpm用的哪个用户。

坑2：cookie_path不对

比如网站装在子目录，但cookie_path设成了别的。

解决：

ini_set('session.cookie_path', '/');
session_start();

坑3：cookie_domain不对

多域名访问时，cookie只在一个域名下有效。

解决：

ini_set('session.cookie_domain', '.example.com');

注意前面有个点，表示所有子域名都生效。

坑4：HTTPS下设了secure

cookie_secure=1表示只在https下传cookie，用http访问就没了。

解决：

session.cookie_secure = 0

或者全站用https。

坑5：session.auto_start冲突

代码里已经session_start()了，但php.ini里也开了auto_start，冲突。

解决：

session.auto_start = 0

六、代码里动态设置

不想改php.ini，可以在代码里设：

<?php
// 必须在session_start()之前

ini_set('session.cookie_path', '/');
ini_set('session.cookie_domain', '.example.com');
ini_set('session.cookie_lifetime', 0);

session_start();

$_SESSION['user_id'] = 1;

七、检查session是否生效

写个测试页：

<?php
session_start();

// 第一次访问，设置
if (!isset($_SESSION['count'])) {
    $_SESSION['count'] = 1;
} else {
    $_SESSION['count']++;
}

echo "访问次数: " . $_SESSION['count'];
echo "<br>";
echo "Session ID: " . session_id();
echo "<br>";
echo "Session 文件: " . session_save_path() . "/sess_" . session_id();

刷新页面，数字应该一直涨。

如果不涨： 就是session没存住。

八、常见场景

场景1：登录后刷新就掉

原因： cookie_path或domain不对。

解决： 检查cookie配置。

场景2：换了个子域名就掉

比如 www.example.com 登录了，跳到 bbs.example.com 就没登录。

原因： cookie_domain没设成 .example.com。

解决：

ini_set('session.cookie_domain', '.example.com');

场景3：从http跳到https就掉

原因： cookie_secure=1，但http不带cookie。

解决： 全站用https，或者关掉secure。

场景4：session目录满了

原因： session文件太多。

解决： 清理旧session，或者设gc_maxlifetime。

session.gc_maxlifetime = 1440

九、快速排查清单

1. F12看cookie里有没有PHPSESSID
2. 没有 → 查cookie_path、cookie_domain、cookie_secure
3. 有 → 查session目录权限
4. 都没问题 → 看session.auto_start有没有冲突
5. 跨域问题 → cookie_domain设成 .主域名

总结

记住：

1. session靠cookie传session_id
2. 先看cookie里有没有PHPSESSID
3. 没有就查cookie配置
4. 有就查session目录权限
5. 跨域名记得设cookie_domain=.主域名

最常用：

ini_set('session.cookie_path', '/');
session_start();

遇到问题加QQ23979811 协助处理