PHP8重构旧代码时自定义SessionHandler会话写入权限错误问题
PHP8适配重构中自定义会话处理器写入失败问题排查
问题触发场景
从PHP4老旧代码向PHP8版本重构迁移过程中,已实现SessionHandlerInterface接口完成自定义会话处理器,执行会话写入操作时触发连续报错,具体报错信息如下:
警告:
file_put_contents(../sessions/sess_fc6a0b26f218654ca0f45493861fdf58): 无法打开流:文件或目录不存在,报错位置为/home/pedro/htdocs/ypanel/session.controller.php第36行
警告:session_write_close(): 使用自定义保存处理器写入会话数据失败。(当前session.save_path配置为:../sessions),报错位置为未知位置第0行
运行环境为Debian系统搭载MySQL的Lampp服务栈。
现有会话处理实现代码
<?php header('Content-Type: application/json'); //========================================================================================= ini_set('session.save_path',realpath(dirname($_SERVER['DOCUMENT_ROOT']) . '/../session')); //========================================================================================= session_save_path("../sessions"); //========================================================================================= error_reporting(2); //========================================================================================= class MySessionHandler implements SessionHandlerInterface { private $savePath; public function open($savePath, $sessionName) { // printf(file_exists($savePath)); // printf(is_dir($this->savePath).' dir'); $this->savePath = $savePath; if (!is_dir($this->savePath)) { chmod($this->savePath,0777); mkdir($this->savePath, 0777,true); } else printf('diretorio ja existe'); return true; } public function close() { return true; } public function read($id) { return (string)@file_get_contents("$this->savePath/sess_$id"); } public function write($id, $data) { return file_put_contents("$this->savePath/sess_$id", $data) === false ? false : true; } public function destroy($id) { $file = "$this->savePath/sess_$id"; if (file_exists($file)) { unlink($file); } return true; } public function gc($maxlifetime) { foreach (glob("$this->savePath/sess_*") as $file) { if (filemtime($file) + $maxlifetime < time() && file_exists($file)) { unlink($file); } } return true; } } $handler = new MySessionHandler(); session_set_save_handler($handler, true); session_start(); ?>
报错成因定位
- 会话保存路径配置冲突与错配:代码中先后两次设置会话保存路径,第一次通过
ini_set()指向了/../session(单数命名的目录),第二次通过session_save_path("../sessions")覆盖成了相对路径的../sessions(复数命名的目录),且后一次的相对路径是基于PHP进程运行时的工作目录解析,不是基于脚本位置,极易出现路径偏移找不到目标目录的问题。 - open()方法逻辑顺序错误:判断目录不存在时,先调用
chmod()修改权限再执行mkdir()创建目录,此时目标目录还未生成,chmod操作没有作用对象,属于无效执行,无法保证后续写入流程能正常执行。 - 权限校验缺失:Lampp栈中PHP进程通常以
www-data用户身份运行,如果目标会话目录的父路径没有给该用户开放读写执行权限,就算目录创建成功,也无法完成会话文件写入。 - 错误上报级别过低:代码中设置
error_reporting(2)仅开启了部分警告类报错,大量路径解析失败、权限不足的核心错误被屏蔽,增加了排查难度。
可行解决方案
- 统一会话保存路径配置:删除重复的两行路径设置代码,改用基于脚本位置解析的绝对路径,从根源上避免相对路径解析偏移问题。可替换为如下逻辑:
保证传入自定义处理器的路径和实际创建的目录名完全一致,消除单复数目录名不匹配的问题。// 基于当前脚本所在目录,向上一层的sessions目录生成绝对路径 session_save_path(realpath(__DIR__ . '/../sessions')); - 修正open()方法的执行逻辑:调整目录创建、权限设置的顺序,增加可写性校验,避免无效操作:
public function open($savePath, $sessionName) { $this->savePath = $savePath; // 目录不存在时先递归创建 if (!is_dir($this->savePath)) { mkdir($this->savePath, 0755, true); // 创建完成后再设置合理权限(无需过度设置0777权限) chmod($this->savePath, 0755); } // 增加可写性校验,不可写时抛出明确错误 if (!is_writable($this->savePath)) { throw new RuntimeException("会话保存路径{$this->savePath}无写入权限,请检查目录权限配置"); } return true; } - 修正目录所有者权限:通过命令行将会话目录的所有者调整为PHP运行用户,执行命令:
chown -R www-data:www-data /home/pedro/htdocs/ypanel/sessions - 调整错误上报配置:将
error_reporting(2)替换为PHP8适配的全量错误上报逻辑,开发阶段可临时打开错误显示,方便定位问题:error_reporting(E_ALL); ini_set('display_errors', 1); - 临时校验路径配置:在open方法中临时添加路径调试代码,确认实际传入处理器的保存路径和预期一致,避免路径错配:
// 临时调试代码 var_dump("实际会话保存路径:{$this->savePath}", is_dir($this->savePath), is_writable($this->savePath));
内容的提问来源于stack exchange,提问作者Pedro Jintan
相关产品推荐
相关产品推荐

