PHP 8.6 的七条弃用:代码没动,运行时行为变了
PHP 8.6 于 2026 年 11 月 19 日发布。官方 release notes 列了一批弃用和向后不兼容变更,其中一部分不只是「以后会报 Deprecated」,而是从 8.6 起运行时行为就已经变了。下面挑出七条影响最直接的。
1. finally 里的 return 被弃用
function getConfig(): array {
try {
return loadConfig();
} finally {
return [];
}
}
try 里抛出的异常会被 finally 的 return 直接吞掉,try/catch 的返回值也会被覆盖。上面这段调用方永远拿到 [],异常不见踪影。8.6 在编译期给出 Deprecated: Returning from a finally block is deprecated.
同样被弃用的还有:从 __construct()/__destruct() 返回值、把这两个方法写成生成器、__debugInfo() 使用可空返回类型。
2. trim 系列默认去掉 \f
trim()、ltrim()、rtrim() 的默认字符集现在包含换页符 \f(0x0C)。解析固定宽度文本、表单馈送、老式打印输出的代码,如果依赖 \f 留在字符串里充当字段边界,结果会变。
3. flush/close 失败不再静默
fclose()、file_put_contents()、copy() 在 flush 或关闭流失败时返回 false。以前这类失败被静默忽略,调用方以为写成功了。写日志、写缓存的路径要开始检查返回值。
4. 越界值、非法 flag、含 NUL 的字符串改为抛 ValueError
不少函数遇到越界参数、无效 flag、或带 NUL 字节的字符串时,以前是静默截断或忽略,现在直接抛 ValueError。这类改动没有统一的 grep 模式,只能靠测试覆盖。
5. mbstring 正则弃用
mb_ereg()、mb_split() 等 mbstring 正则函数弃用,原因是底层的 Oniguruma 不再维护。替代方案是带 u 修饰符的 PCRE:preg_match('/.../u', $s)。
6. php://filter 默认最多 16 个过滤器
php://filter 链超过 16 个过滤器时给出弃用警告。这个上限是为了挡住从 LFI 到 RCE 的利用链——公开 payload 用到 47、50、100 个过滤器:1 个用来阻止被 include 的文件执行,5 个做错误 oracle 逐字符读,11 个走 iconv 利用,47 个在 /etc/passwd 前拼 %PDF,50 个用错误 oracle 回显文件内容,100 个直接落 webshell。Sourcegraph 的统计里绝大多数用法只有 1 个过滤器,偶尔 2 个,CTF 之外没有 5 个以上的合法场景。
放开上限只能用 stream context 选项 filter.max_filter_count,没有对应的 INI 设置。PHP 8.7 起超限直接报错。stream_filter_append()/stream_filter_prepend() 不受此限制。
7. session 默认值更安全
session.use_strict_mode 和 session.cookie_httponly 默认开启,session.cookie_samesite 默认 Lax。自定义 session handler 如果没同时实现 create_sid() 和 validateId(),会被弃用警告点名。
grep 自查清单
# finally 里的 return
grep -rn --include='*.php' -A5 'finally' . | grep 'return'
# trim 系列
grep -rnE '\b(trim|ltrim|rtrim)\(' --include='*.php' .
# flush/close 返回值
grep -rnE '\b(fclose|file_put_contents|copy)\(' --include='*.php' .
# mbstring 正则
grep -rnE '\b(mb_ereg|mb_eregi|mb_ereg_replace|mb_eregi_replace|mb_split)\(' --include='*.php' .
# php://filter 链
grep -rn 'php://filter' --include='*.php' .
# 自定义 session handler 与 session INI
grep -rnE 'SessionHandler|session_set_save_handler' --include='*.php' .
grep -rnE 'session\.(use_strict_mode|cookie_httponly|cookie_samesite)' --include='*.ini' .
其余弃用项
let/is 不能再作类名、函数名、常量名,_ 不能作常量名,readonly 不能作函数名。is_double()/is_long()/is_integer()/doubleval() 换成 is_float()/is_int()/floatval();spl_object_hash() 换 spl_object_id(),spl_classes() 换 ReflectionExtension::getClassNames();对象传给 array_walk()、http_build_query()、mb_convert_variables() 等改用 get_object_vars();strcoll() 和 SORT_LOCALE_STRING 换 intl 的 Collator;define() 第三参数、is_a()/is_subclass_of() 在 $allow_string=false 时传类名字符串均已弃用。metaphone()、mysqli_get_charset()、mysqli_stmt_init()、SplFileObject 的 CSV 方法、ArrayIterator 的排序/flag/序列化方法同样在列。
8.6 新增的部分包括 partial function application、Time\Duration、Io\Poll、clamp()、SortDirection 枚举、readonly 属性默认值、ReflectionProperty::isReadable()/isWritable(),以及 error_include_args INI。
来源
- PHP 8.6 release notes:https://www.php.net/releases/8.6/en.php
- 过滤器链数量限制 RFC:https://wiki.php.net/rfc/limit-maximum-number-of-filter-chains