PHP版本不匹配是Laravel升级首要障碍，必须严格匹配：Laravel 9≥8.0、10≥8.1、11≥8.2；需先执行php -v确认版本，再同步更新composer.json中"php"字段（如"^8.2"），否则composer update会静默失败或装错依赖导致Class not found。
直接升级 Laravel 项目时，PHP 版本不匹配是第一个拦路虎——不是报错不明显，就是 composer update 静默失败或装错依赖树，最终表现为 Class 'Illuminate\Support\ServiceProvider' not found 或 artisan 命令根本无法启动。
确认当前 PHP 版本与目标 Laravel 版本是否兼容
别跳过这步：Laravel 主版本对 PHP 有硬性要求，且不可协商。运行 php -v 查看实际版本，再对照目标 Laravel 版本的官方要求：
- Laravel 9 → 要求 PHP ≥ 8.0
- Laravel 10 → 要求 PHP ≥ 8.1（不支持 8.0）
- Laravel 11 → 要求 PHP ≥ 8.2（不支持 8.1 及更低）
若当前是 PHP 8.0.x，想升到 Laravel 11，必须先升 PHP 到 8.2+，再动框架；若仍是 7.4 或 8.0，composer update 会卡在依赖解析阶段，错误提示常为：Your requirements could not be resolved to an installable set of packages.
composer.json 中 "php" 字段必须显式更新
很多人只改 "laravel/framework": "^11.0"，却忽略 "php" 行。Composer 默认沿用旧约束，可能导致它“妥协”安装低版本 illuminate 包，引发运行时断裂。
立即学习“PHP免费学习笔记（深入）”；
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
正确做法：
- 将
"php": "^8.0"或空值，改为明确的"php": "^8.2"（对应 Laravel 11） - 保存后运行
composer update --with-all-dependencies，强制全链路适配 - 若本地 PHP 环境未就绪，Composer 会直接报错并中止，这反而是好事——比装完跑不起来更早暴露问题
PHP 升级后常见扩展缺失问题
PHP 8.2 移除了部分旧扩展（如 ext-mcrypt），同时强化了类型检查。升级后常见现象：
-
Class 'Mcrypt' not found：Laravel 9+ 已弃用 mcrypt，改用openssl_encrypt，需移除所有手动调用 -
Declaration of App\Providers\AppServiceProvider::register() must be compatible with：PHP 8.2 对方法签名更严格，检查所有 Service Provider 的register()和boot()是否带正确返回类型声明（如void） -
Undefined array key类警告变 Notice 级别：PHP 8.2 默认开启error_reporting = E_ALL，旧代码里未判空的$arr['key']会直接报错，需补??或isset()
升级后验证 PHP 层兼容性的关键点
光让 artisan 启动成功不够，得验证运行时行为是否一致：
- 执行
php artisan tinker，输入new DateTime();确认日期类无异常 - 跑一次队列任务：
php artisan queue:work --once，检查序列化/反序列化是否正常（PHP 8.2 对__serialize/__unserialize更敏感） - 触发一个含文件上传的请求，确认
$_FILES结构和临时路径逻辑未变（PHP 8.2 修改了部分上传错误码语义） - 查看日志中是否有
Deprecated:开头的行——这些在 PHP 8.2 下可能已升级为Warning或直接Error
最易被忽略的是：PHP 升级后，opcache.enable_cli=1 可能导致 artisan 命令缓存旧字节码，务必在 php.ini 中设为 0 或执行 php -d opcache.enable_cli=0 artisan ... 验证。
