PHP 8.6 收紧了 session 默认值:自研 handler 会在哪三处挂
PHP 8.6.0 计划于 2026-11-19 发布。这次 session 部分的改动相当集中,受影响最大的恰恰是自己实现 SessionHandlerInterface 的项目——默认值一变,原来「能跑」的实现会在三个地方同时出问题。
迁移说明:
- Backward Incompatible Changes:https://www.php.net/manual/en/migration86.incompatible.php
- Deprecated Features:https://www.php.net/manual/en/migration86.deprecated.php
三个默认值变了
| INI 设置 | 旧默认 | 新默认 |
|---|---|---|
session.use_strict_mode | 0 | 1 |
session.cookie_httponly | 0 | 1 |
session.cookie_samesite | 未设置 | Lax |
目标都是开箱即用的安全行为,但每一条都会改变现有代码的实际运行结果。
strict mode 与自研 handler 的冲突
session.use_strict_mode=1 会拒绝未初始化的 session ID,用来缓解 session fixation。问题在于,很多自研 handler 原本就依赖「外部传什么 ID 都接受,哪怕存储里根本没有对应的条目」。默认值改成 1 之后,这类实现拿不到有效 ID,行为直接变形。
PHP 8.6 的弃用说明写得更明确:传给 session_set_save_handler() 的对象,如果没有同时实现 SessionIdInterface::create_sid() 和 SessionUpdateTimestampHandlerInterface::validateId(),无论它声明了哪些接口,现在都会产生弃用提示。这两个方法正是 save handler 在 strict mode 下正确工作所必需的。相应地,一个类只实现 SessionHandlerInterface 而不定义这两个方法时,现在会发出 E_WARNING。到 PHP 9.0,这两个方法会被移进 SessionHandlerInterface,变成必需项。
另外,SessionHandler::validateId() 是新增的,会委托给已配置的 save handler。子类如果声明了 SessionHandler::validateId() 却没有写返回类型,会因为 tentative bool 返回类型收到弃用提示;子类覆盖 SessionHandler::open() 又不调用 parent::open() 的,保持原有行为,但在验证 ID 时会发一条 warning。
session_encode() 对空 session 返回空字符串
原来空 session 返回 false,现在返回空字符串。只有 session 数据无法编码时才返回 false——在默认序列化 handler 下,这主要发生在某个键包含管道符 | 的时候。
连带的效果是 lazy_write:当 session.lazy_write 开启、handler 实现了 SessionUpdateTimestampHandlerInterface 时,读取时为空、写入时仍为空的 session,现在触发 SessionUpdateTimestampHandlerInterface::updateTimestamp(),而不是 SessionHandlerInterface::write()。以前因为 session_encode() 返回 false,绕过了 lazy_write 的比较,空 session 也总会调到 write()。所以那些靠「write() 被空数据调用」来销毁 session 的代码,需要把同样的逻辑搬到 updateTimestamp() 里。
跨站 POST 会掉登录
session.cookie_samesite=Lax 之后,session cookie 不再随跨站请求发送,只有使用安全 HTTP 方法的顶层导航例外。依赖跨站 POST 携带 session cookie 的应用,必须显式设成 "None",并且同时把 session.cookie_secure 设为 1。
session.cookie_httponly=1 则意味着 document.cookie 读不到 session cookie。有 JS 侧读取需求的应用要显式设回 0。
同批还有两处小改动:session.cookie_path、session.cookie_domain、session.cache_limiter 被设成含 NUL 字节的值时,会发 warning 并保持设置不变;session_module_name() 在 name 含 NUL 字节时抛 ValueError。
怎么判断自己是否受影响
- 检查 handler 类声明。 类头只写了
implements SessionHandlerInterface、方法列表里没有create_sid()和validateId(),基本就是受影响对象。 - 用伪造 sid 发一次请求。 带一个存储里不存在的
PHPSESSID访问受保护页面,看响应里Set-Cookie是否给出了全新的 session ID——strict mode 拒绝旧 ID 后才会重新生成。 - 看
Set-Cookie头属性。 确认HttpOnly和SameSite=Lax是否出现在 session cookie 上,这是判断 cookie 默认值是否生效最直接的方式。 - 测试空 session 路径。 开 session 但不写任何数据,观察 handler 的
write()是否还被调用。如果销毁逻辑挂在write()里,这条路已经断了。
两条路
路线一:补齐接口
class MyHandler implements
SessionHandlerInterface,
SessionIdInterface,
SessionUpdateTimestampHandlerInterface
{
// open/close/read/write/destroy/gc 省略
public function create_sid(): string
{
return bin2hex(random_bytes(16));
}
public function validateId(string $id): bool
{
return $this->exists($id); // 存储里真有这条才算有效
}
public function updateTimestamp(string $id, string $data): bool
{
// 原先写在 write() 里的空数据处理(例如销毁)搬到这里
if ($data === '') {
return $this->destroy($id);
}
return $this->touch($id);
}
}
路线二:显式改回旧值
session.use_strict_mode=0
session.cookie_httponly=0
session.cookie_samesite=
运行时用 ini_set() 也可以,但必须在 session_start() 之前;cookie 相关项尤其要注意时机。如果只是跨站 POST 需要携带 cookie,不必整体回退,设 session.cookie_samesite=None 加 session.cookie_secure=1 即可。
顺带几处弃用
mbregex 整组弃用
底层 Oniguruma 库自 2025 年 4 月起停止维护,所以 mbregex 系列函数全部弃用,PHP 9.0 移除。名单是:mb_ereg、mb_ereg_match、mb_ereg_replace、mb_ereg_replace_callback、mb_ereg_search、mb_ereg_search_getpos、mb_ereg_search_getregs、mb_ereg_search_init、mb_ereg_search_pos、mb_ereg_search_regs、mb_ereg_search_setpos、mb_eregi、mb_eregi_replace、mb_regex_encoding、mb_regex_set_options、mb_split。常量 MB_ONIGURUMA_VERSION 和 ini 项 mbstring.regex_retry_limit、mbstring.regex_stack_limit 一并弃用。
替代方案是 PCRE 函数加 u 修饰符:
// mb_ereg_replace('(\d+)', '[$1]', $s);
preg_replace('/(\d+)/u', '[$1]', $s);
php://filter 超过 16 个过滤器
没有配置 filter.max_filter_count 流上下文选项时,URL 里用超过 16 个过滤器会触发弃用提示。长过滤链没有已知的合法用途,但它是把本地文件包含、任意文件读取升级成远程代码执行的一类攻击的基础。显式设置这个选项时,超限已经是错误:打开流会失败并产生 warning。
需要更多过滤器,可以用 stream_filter_append() 或 stream_filter_prepend()(不受此限制),也可以通过上下文选项抬高上限,例如用 stream_context_set_default() 全局设置:
stream_context_set_default([
'filter' => ['max_filter_count' => 32],
]);
finally 里 return
在 finally 块里使用 return 现在弃用,编译期产生弃用提示。它会静默丢弃 try/catch 抛出的异常,或者覆盖其返回值。
function getConfig(): array
{
try {
return loadConfig();
} finally {
return [];
}
}
上面这段里,loadConfig() 抛出的异常会被吞掉,返回值也会被 [] 覆盖。
其余不展开
trim/ltrim/rtrim 默认多去掉 form feed \f;fclose、file_put_contents、copy 在 flush 或关闭失败时返回 false 而非静默忽略;多个函数对越界值、非法 flag、含 NUL 字节的字符串改抛 ValueError(如 getenv/putenv、parse_str、proc_open 的 cwd、filesize/filemtime 等);unpack() 格式名里紧跟的 < 或 > 现在当作端序修饰符处理。