PHP 8.6 升级 Laravel 应用:让 CI 先执行,把 E_DEPRECATED 变成测试失败
PHP 8.6 将于 2026 年 11 月 19 日 GA,RC2 已经发布。每个 minor 版本都会重复同样的混乱:某个依赖还没声明支持、Sentry 被 E_DEPRECATED 填满、需要的 Docker tag 还不存在。
下面是我在 Laravel 应用上按顺序执行的清单:CI 先做,弃用其次,运行时最后。按这个顺序,麻烦的发现会出现在 pull request 里,而不是晚上 11 点的生产机器上。
先问 Composer:依赖树能不能解开
在改动任何代码之前,先确认依赖树能否在 PHP 8.6 上解析。why-not 会明确指出哪个包卡住了平台约束。
# Which packages block PHP 8.6?
composer why-not php 8.6
# What's lagging behind, direct dependencies only
composer outdated --direct
Laravel 13 声明 php: ^8.3,框架本身没有上限。阻碍几乎总在依赖树的更下面:某个静态分析工具、某个 PDF 库,或者一个被固定在 <8.6 的废弃包。不要把框架大版本升级和 PHP minor 升级放在同一个 pull request 里。
如果某个包被卡住,而上游修复已经合并,可以临时加一条 "config": {"platform": {"php": "8.5.0"}},让本地安装保持稳定,同时让 CI 去测真实的 8.6。
把 8.6 加进 CI 矩阵
今天就把 8.6 作为非阻塞 job 放进矩阵,等全部通过后再提升为必需。shivammathur/setup-php 接受 8.6,会从 PHP-8.6 分支安装 nightly 或 RC 构建。
jobs:
tests:
runs-on: ubuntu-latest
strategy:
fail-fast: false
matrix:
php: ['8.3', '8.4', '8.5']
include:
- php: '8.6'
experimental: true
continue-on-error: ${{ matrix.experimental == true }}
steps:
- uses: actions/checkout@v4
- uses: shivammathur/setup-php@v2
with:
php-version: ${{ matrix.php }}
tools: composer:v2
# RC builds need ignore-platform-reqs on some transitive deps
- run: composer update --prefer-dist --no-interaction --ignore-platform-req=php+
- run: php artisan test
注意这里是 --ignore-platform-req=php+,不是一刀切的 --ignore-platform-reqs。+ 后缀只放宽上限,所以真正需要 PHP 8.4 的包依然会让构建失败。
把弃用变成失败的测试
只写进日志文件的弃用提示等于没人管。把它们转成测试失败。Laravel 的 TestCase 不做这件事,需要自己加一个 bootstrap 错误处理器,对来自自有代码的 E_DEPRECATED 抛异常;vendor 里的弃用是别人的 pull request,过滤掉。
<?php
// tests/Pest.php (or bootstrap/testing.php)
set_error_handler(function (int $severity, string $message, string $file, int $line): bool {
if ($severity !== E_DEPRECATED) {
return false; // fall through to PHP's handler
}
// Only fail on deprecations in first-party code.
if (! str_starts_with($file, base_path('app')) && ! str_starts_with($file, base_path('src'))) {
return true; // swallow vendor noise
}
throw new ErrorException($message, 0, $severity, $file, $line);
});
在 8.6 上先去掉过滤跑一遍测试套件,把输出重定向到文件。那份列表就是你的 vendor 升级待办。
用 grep 找已弃用的函数
PHP 8.6 的弃用 RFC 是逐项投票的,所以通过列表比提案窄。下面这些是真正会出现在 Laravel 代码库里的,全部计划在 PHP 9.0 移除。
# Object identity — spl_object_id() returns an int and is faster
rg -n 'spl_object_hash\(' app src
# Type-check aliases: is_integer/is_long -> is_int, is_double -> is_float
rg -n 'is_integer\(|is_long\(|is_double\(|doubleval\(' app src
# Oniguruma is EOL: the whole mb_ereg* family is deprecated
rg -n 'mb_ereg|mb_split|mb_regex_encoding' app src
# is_a()/is_subclass_of() with a string subject and $allow_string = false
rg -n 'is_subclass_of\(|is_a\(' app src
比较隐蔽的一个是在 finally 块里 return,现在会产生编译期弃用。它被弃用是因为它悄悄丢弃了 try 里正在做的事——包括异常:
function getConfig(): array
{
try {
return loadConfig(); // throws if the file is missing
} finally {
return []; // PHP 8.6: Deprecated. The exception vanishes.
}
}
名单上还有 strcoll()、metaphone()、SORT_LOCALE_STRING、spl_classes()、SplFileObject 的 CSV 方法、带 $case_insensitive 的 define()、mysqli::stmt_init()、mysqli_get_charset()、dechunk 流过滤器,以及值类型与声明类型不符时的 ReflectionProperty::setValue()。在期望数组的地方传对象——array_walk()、http_build_query()、mb_convert_variables()——也被弃用了;这一条最容易击中依赖 ArrayObject 的遗留 service 类。
跑 Rector 和 PHPStan
<?php
// rector.php
use Rector\Config\RectorConfig;
return RectorConfig::configure()
->withPaths([__DIR__ . '/app', __DIR__ . '/tests'])
// Reads the "php" constraint from composer.json — no hardcoded set name.
->withPhpSets()
->withPreparedSets(deadCode: true);
composer require --dev rector/rector
vendor/bin/rector process --dry-run
Rector 不会覆盖全部情况。finally 里的 return 需要人来判断正确的控制流原本是什么,is_a() 的变更取决于运行时类型。这正是静态分析的价值所在——把 Laravel 应用推到 PHPStan level 10,值得在升级之前做,而不是升级途中做。
新的 session 与 stream 默认值
session 的默认值变成了 session.use_strict_mode = 1(原 0)、session.cookie_httponly = 1(原 0)、session.cookie_samesite = Lax(原未设置)。
Laravel 不用 PHP 原生 session handler,cookie 由 config/session.php 和它自己的 StartSession 中间件管理,所以标准 Laravel 应用的行为完全不变。风险在边角:还在调 session_start() 的旧后台、写 $_SESSION 的第三方 SDK,或者依赖跨站 POST 的 SAML/OAuth 回调。Lax 会拦掉跨站 POST 上的 cookie,而大多数 SSO assertion 正是那样到达的。另外检查 session_set_save_handler():传入没有实现 create_sid() 和 validateId() 的 handler 对象现在会被弃用。
Stream 错误处理:如果代码里是 @fopen(...) 加 error_get_last(),这个模式依赖精确的错误文本,会静默失效。
更新 Docker 镜像与生产运行时
FROM php:8.6.0RC2-fpm-trixie AS base
固定完整的 RC tag,不要用浮动的 8.6-rc 别名——浮动 tag 会在你脚下移动。第三方扩展通常是延迟来源:确认 redis、imagick、xdebug、pcov 和 swoole/openswoole 有 8.6 兼容版本。托管平台(Forge、Laravel Cloud、Vapor)一般在 GA 后几周内提供 PHP minor,所以按 12 月的窗口来排。
灰度发布
不要在 GA 当天上线。PHP minor 的 .0 版本在前两周稳定产出回归报告,8.6.1 会在 12 月发布。盯应用日志里的 E_DEPRECATED,不只盯 fatal。生产环境把 error_reporting 保持在 E_ALL,把弃用以低严重级别送进错误追踪。回滚就是换镜像 tag。
几个容易踩的行为变更
list() 没有被弃用。 提案以 23–23、一票弃权被否。list($a, $b) = $array 没问题。
trim() 现在会剥掉换页符。 trim()、ltrim()、rtrim() 和 chop() 的默认字符集里包含了 \f。如果你的代码在解析定宽文件或把 \f 当分页符的旧打印流,解析器会悄悄开始吃掉分隔符。
array_filter() 遇到非法 $mode 会抛异常。 第三个参数传无效值时现在抛 ValueError,不再被忽略。那些传 true 而不是 ARRAY_FILTER_USE_KEY 的代码已经错了很多年,现在会明确失败。
弃用数量不等于严重程度。 热循环里一个 spl_object_hash() 调用能产生成千上万条相同 notice,按 message 和 file 去重。
vendor 的弃用不该在应用里修。 别去 patch vendor/。开上游 issue,锁定版本。
收尾
今天就把 8.6 的矩阵 job 加上,跑一遍 grep,让弃用待办在 pull request 里累积六周。现在做很便宜,拖到 11 月就很贵。