本地运行Laravel应用遇PHP版本兼容错误，求解决方法

算力阿峰

2026-7-6

解决Laravel 5.6与PHP 8.2.4版本冲突问题

问题根源

你的composer.json里同时指定了php: ^7.3||^8.0和laravel/framework: 5.6.*，但Laravel 5.6仅支持PHP 7.1.3~7.3.x版本，和当前使用的PHP 8.2.4完全不兼容，这就是报错的核心原因。

方案一：降级PHP版本到兼容范围

Laravel 5.6适配PHP 7.1.3~7.3.x，推荐选择PHP 7.3.x（该区间内的最高稳定版），切换方法根据你使用的本地环境工具而定：

用Valet：先安装对应版本，再执行valet use php@7.3
用XAMPP/WAMP：直接下载PHP 7.3的安装包，替换或切换环境中的PHP版本
用phpbrew：执行phpbrew install 7.3.33 +default，再运行phpbrew switch php-7.3.33
切换完成后，重新执行composer install即可正常安装依赖。

方案二：升级Laravel版本到支持PHP 8.2的分支

注意：升级前务必备份项目代码，避免兼容问题导致数据或代码丢失

修改composer.json中的依赖项，以升级到Laravel 9（支持PHP 8.0~8.2）为例：

将laravel/framework从5.6.*改为^9.0

同步更新其他依赖确保版本兼容，修改后的示例片段：

"require": {
    "php": "^8.0.2",
    "brian2694/laravel-toastr": "^5.5",
    "fideloper/proxy": "^4.0",
    "intervention/image": "^2.7",
    "laravel/framework": "^9.0",
    "laravel/tinker": "^2.7",
    "ext-gd": "*"
},
"require-dev": {
    "filp/whoops": "^2.14",
    "fakerphp/faker": "^1.21",
    "mockery/mockery": "^1.5",
    "nunomaduro/collision": "^6.3",
    "phpunit/phpunit": "^9.5"
}