Laravel 10 最低需 PHP 8.1.0,因官方硬性要求且核心已使用只读属性等 PHP 8.1 特性;低于该版本时 Composer 会直接报错“Your requirements could not be resolved”或拒绝安装,推荐使用 PHP 8.2 以获更优性能、稳定性和升级兼容性。

Laravel 10 最低需要 PHP 8.1.0 版本才能安装。
为什么必须是 PHP 8.1+
这是 Laravel 官方硬性要求,不是建议。框架核心已使用 PHP 8.1 的语言特性(如只读属性、枚举增强等),Composer 在解析依赖时会直接拒绝低于该版本的 PHP 环境。
常见报错示例:
-
composer create-project 运行几秒后退出,提示:
your php version (7.4.33) does not satisfy that requirement -
composer install 卡住或报错:
Your requirements could not be resolved to an installable set of packages
推荐使用 PHP 8.2
虽然 8.1 是最低门槛,但 Laravel 官方文档和社区实践更推荐 PHP 8.2:
立即学习“PHP免费学习笔记(深入)”;
- 性能更优,尤其在类型推导与 JIT 编译方面
- 兼容性更稳,避免某些扩展(如 opcache、mbstring)在 8.1 中的边缘 bug
- 为后续升级 Laravel 11(预计支持 PHP 8.2+)提前铺平路径
验证当前 PHP 版本是否达标
运行以下命令确认 CLI 模式下的真实版本:
php -v
输出应类似:PHP 8.1.27 或 PHP 8.2.12。注意:Web 服务器(如 Nginx/Apache)使用的 PHP 版本可能不同,但 Composer 安装只认 CLI 版本。



















