Laravel 11 强制要求 PHP ≥ 8.2，是硬性门槛而非建议；低于该版本，Composer 拒绝解析依赖、artisan 失败、php -v 即不通过，且核心功能依赖 PHP 8.2 特性（如 readonly 类、协变返回类型），无降级兼容路径。
Laravel 11 明确要求 PHP ≥ 8.2，这不是建议，而是硬性门槛。低于该版本，项目根本无法完成安装或启动——Composer 会直接拒绝解析依赖，artisan 命令执行失败，甚至 php -v 检查阶段就已不通过。所谓“兼容方案”，本质是绕开 Laravel 11，而非降级适配它。
PHP 8.2 是强制前提，没有替代路径
Laravel 11 的核心代码大量使用 PHP 8.2 新增特性，例如只读类（readonly classes）、显式协变返回类型、改进的 var_export 行为等。这些不是可选优化，而是框架运行的基础语法支撑。即使强行修改 composer.json 或 patch vendor，也会在 artisan serve、路由加载、模型序列化等环节崩溃，报 Target class does not exist 或 Undefined array key 等底层错误。
低版本 PHP 环境的现实选择
如果你当前系统只能运行 PHP 8.1 或更低（如 CentOS 7 默认 PHP 7.4、macOS 自带 PHP 8.0），请勿尝试“打补丁”或“改配置”来跑 Laravel 11。可行做法只有以下三项：
- 升级 PHP 环境：macOS 用 brew install php@8.2；Ubuntu/Debian 执行 apt install php8.2-cli php8.2-mbstring php8.2-xml php8.2-curl php8.2-tokenizer php8.2-zip php8.2-opcache；Windows 用户务必使用官方 Composer-Setup.exe（自带 PHP 8.2 运行时）或 WSL2 中独立安装 PHP 8.2
- 降级框架版本：若必须用 PHP 8.1，应选用 Laravel 10.x（支持 PHP 8.1+）；若仅能用 PHP 8.0，则对应 Laravel 9.x；PHP 7.4 只能止步于 Laravel 6/7，且这些旧版本已停止安全更新
- 放弃本地开发环境模拟：phpEnv、XAMPP、WampServer 等集成包普遍最高仅支持 PHP 7.4，无法启用 Laravel 11 所需扩展（如 FFI、sodium），也不支持 Composer 3.x，不建议投入时间调试
常见误区与验证动作
很多开发者误以为“只要 php -v 显示 8.2 就够了”，其实还需确认 CLI 模式下所有扩展真实生效：
立即学习“PHP免费学习笔记（深入）”；
- 运行 php -m | grep -E "(mbstring|openssl|tokenizer|xml|curl|pdo|json)" —— 缺任一即失败，Windows 用户要检查 php.ini 中 extension=php_mbstring.dll 是否取消注释并重启服务
- 执行 php -r "echo str_starts_with('abc', 'a');" —— 若报 Fatal error，说明 PHP 实际未达 8.2，可能是 PATH 混淆了多个 PHP 版本
- 别信 phpinfo() 页面：它反映的是 Web 服务器（如 Apache）所用 PHP，而 Composer 和 artisan 使用的是 CLI 模式 PHP，二者可能完全不同
不要尝试的“伪兼容”操作
以下方法看似省事，实则埋下严重隐患，均已被 Laravel 官方明确否定：
- 修改 laravel/framework 的 composer.json 中 php 版本约束（如改成 ^8.1）—— Composer 3.x 会因元数据校验失败而中断
- 用 --ignore-platform-reqs 强行安装 —— 导致 vendor 中混入不兼容的 illuminate/* 组件，artisan 命令随机静默退出
- 在 .env 中设置 APP_DEBUG=true 后反复刷新看错误详情 —— 多数底层不兼容问题不抛异常，只返回 500 或空响应，无法定位
