Laravel 10 不支持 PHP 7.4,官方硬性要求 PHP ≥ 8.1;因其大量使用 PHP 8.1+ 特性(如 enum、readonly、联合类型等),Composer 在依赖解析阶段即报错,无法安装或运行。

Laravel 10 不支持 PHP 7.4,这是硬性限制,无法绕过。
官方明确要求:PHP ≥ 8.1。如果你在 PHP 7.4 环境下执行 composer create-project laravel/laravel,Composer 会直接报错,例如:
- laravel/framework[v10.0.0, ..., v10.48.20] require php ^8.1 -> your php version (7.4.33) does not satisfy that requirement.
这是因为 Laravel 10 大量使用了 PHP 8.1+ 的语言特性,比如:
- 原生枚举(
enum) - 只读属性(
readonly) - 新的联合类型语法(如
string|int|null) -
array_is_list()、str_contains()等内置函数(PHP 8.0+ 引入,但 Laravel 10 全面依赖 8.1+ 生态)
所以,你不能“尝试安装”成功——它根本不会通过 Composer 的依赖解析阶段。
立即学习“PHP免费学习笔记(深入)”;
如果你当前只能用 PHP 7.4,有且仅有两个现实选择:
-
降级框架版本
改用 Laravel 8.x(最低支持 PHP 7.3)或 Laravel 9.x(最低 PHP 8.0,仍不兼容 7.4)→ 实际上,Laravel 8 是最后一个支持 PHP 7.4 的主版本。
安装命令示例:composer create-project laravel/laravel myapp "8.*"
-
升级 PHP 环境(推荐)
PHP 7.4 已于 2022 年 11 月终止所有支持(EOL),不再接收安全更新,存在已知漏洞风险。
升级到 PHP 8.1 或更高(如 8.2/8.3),才能安全、合规、完整地使用 Laravel 10。
常见升级方式:- Ubuntu/Debian:添加 ondrej/php PPA,运行
sudo apt install php8.1 php8.1-cli php8.1-mbstring ... - macOS(Homebrew):
brew install php@8.1 && brew link --force php@8.1 - Windows(XAMPP/MAMP):更换为支持 PHP 8.1+ 的新版集成环境
- Ubuntu/Debian:添加 ondrej/php PPA,运行
小提醒:别被“安装过程开始”误导
有些用户发现 composer create-project 命令能下载部分文件、甚至生成 .env,就以为“装上了”。其实这只是 Composer 在拉取顶层包描述时的中间状态;一旦进入依赖解析和自动加载注册阶段,PHP 版本校验立刻触发失败,项目无法启动,php artisan 会直接报 ParseError 或 Fatal error。
结论很明确:PHP 7.4 和 Laravel 10 不兼容,不是配置问题,不是扩展缺失,是语言层不可逾越的鸿沟。



















