代码 PHP 8.6 收紧了 session 默认值:自研 handler 会在哪三处挂

2026-11-22 21:02:01

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_mode01
session.cookie_httponly01
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。

怎么判断自己是否受影响

  1. 检查 handler 类声明。 类头只写了 implements SessionHandlerInterface、方法列表里没有 create_sid() 和 validateId(),基本就是受影响对象。
  2. 用伪造 sid 发一次请求。 带一个存储里不存在的 PHPSESSID 访问受保护页面,看响应里 Set-Cookie 是否给出了全新的 session ID——strict mode 拒绝旧 ID 后才会重新生成。
  3. 看 Set-Cookie 头属性。 确认 HttpOnly 和 SameSite=Lax 是否出现在 session cookie 上,这是判断 cookie 默认值是否生效最直接的方式。
  4. 测试空 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() 格式名里紧跟的 < 或 > 现在当作端序修饰符处理。

复制全文 生成海报 PHP Session 升级迁移

推荐文章

程序员茄子在线接单