Laravel 8.x项目从PHP 7.4升级至PHP 8.1的相关疑问

核心结论：不是仅执行composer update即可，需要调整依赖配置、替换指定包并做兼容性检查，具体步骤如下： #

1. 调整composer.json的依赖配置

   • PHP版本约束：当前"php": "^7.3|^8.0"已经兼容PHP8.1（^8.0语义化版本规则包含8.1），无需修改；若要明确标注支持8.1，可改为"php": "^7.3|^8.0|^8.1"。
   • 替换Faker包：将require-dev中的"fzaninotto/faker": "^1.9"替换为"fakerphp/faker": "^1.19"（Laravel 8.x适配的稳定版本），原包已停止维护，官方已切换至fakerphp/faker。
   • 替换Redis客户端：移除require中的"predis/predis": "^1.1"，添加"ext-redis": "*"（需确保服务器已安装php-redis扩展）；同时修改config/database.php中的Redis配置，将'client' => env('REDIS_CLIENT', 'predis')改为'client' => env('REDIS_CLIENT', 'phpredis')，可根据需求添加phpredis专属配置项。

2. 执行依赖更新

   • 先备份当前的composer.lock和vendor目录，避免更新失败后难以回滚。
   • 执行composer update，过程中关注依赖兼容性报错：
     • 若某依赖不支持PHP8.1，需升级该依赖至兼容版本（例如calebporzio/parental ^{0.11.0需升级到}0.13.0及以上版本以支持PHP8.1）。
     • 若出现版本冲突，可尝试composer update --with-all-dependencies强制更新依赖链，或逐个调整冲突包的版本约束。

3. 代码兼容性检查与修复

   • 排查项目代码中PHP8.1废弃特性的使用：比如strftime()、each()函数，或未声明的动态属性（PHP8.1默认禁用此类属性，需为对应类添加#[AllowDynamicProperties]注解，或修改代码显式声明属性）。
   • 修复PHP8.1下的语法警告：例如参数类型不匹配、命名空间冲突等，可借助PHPStan或Psalm等静态分析工具批量扫描代码。

4. 功能测试与验证

   • 运行项目单元测试（phpunit），确保所有测试用例通过。
   • 手动验证核心业务功能，排查是否存在运行时错误或异常。

内容的提问来源于stack exchange，提问作者user2268244