本文针对 laravel 项目运行 `php artisan` 命令时出现致命错误（如“class 'illuminate\foundation\application' not found”）的问题，核心原因是 php 版本与 laravel 版本不兼容，重点指导如何通过降级 php 至 7.x 解决该问题。
当你在本地运行 Laravel 前端项目（基于 Blade 模板）时，执行 php artisan serve、php artisan package:discover 或其他 Artisan 命令报出类似下图所示的致命错误（例如类未定义、Autoloader 失败），且已确认安装了 PHP 8.1.2 和 Composer，问题极大概率源于 PHP 版本与 Laravel 框架版本不兼容。
常见场景是：项目基于较老版本的 Laravel（如 5.x 或 6.x）构建，而这些版本官方最低要求为 PHP 7.2+，最高仅支持至 PHP 7.4。Laravel 7 及更早版本不兼容 PHP 8.0+ —— 因为 PHP 8 引入了严格类型检查、构造函数属性提升、mixed 类型等破坏性变更，导致旧版 Illuminate 组件无法加载或初始化。
✅ 正确解决方案是：将 PHP 切换至兼容版本（推荐 PHP 7.4），而非强行升级 Laravel 或忽略错误。
✅ 操作步骤如下：
-
确认当前 PHP 版本
立即学习“PHP免费学习笔记（深入）”；
php -v
若输出为 PHP 8.1.2，则需切换。
-
安装并启用 PHP 7.4（以 macOS + Homebrew 为例）
brew install php@7.4 brew link --force php@7.4
Windows 用户可使用 XAMPP 或 WAMP 安装 PHP 7.4 环境；Linux 用户可通过 apt 或 ppa:ondrej/php 安装：
sudo apt install php7.4-cli php7.4-mbstring php7.4-xml php7.4-zip php7.4-curl
-
验证 PHP CLI 是否已切换成功
php -v # 应显示 PHP 7.4.x which php # 确认路径指向 PHP 7.4（如 /usr/local/bin/php）
-
清理并重试 Artisan 命令
rm -rf vendor/ composer.lock composer install --no-scripts # 先跳过脚本执行（避免 discover 报错） composer dump-autoload php artisan package:discover php artisan serve
⚠️ 注意事项：
- 不要依赖 --ignore-platform-reqs 强行绕过版本检查，它仅跳过 Composer 的版本约束，无法修复运行时 PHP 8 的语法/行为不兼容问题；
- 若项目 composer.json 中 platform.php 显式指定 "7.4"，但系统 PHP 是 8.1，则 Composer 安装可能看似成功，但 Artisan 运行时仍会崩溃；
- 升级 Laravel 至 9.x+ 可支持 PHP 8.1，但需全面测试兼容性（含第三方包），对老旧项目成本较高，版本降级是最快速、低风险的调试方案。
总结：Artisan 命令启动失败，首要排查 PHP 版本兼容性。Laravel ≤7.x → 用 PHP 7.4；Laravel ≥9.x → 可用 PHP 8.1+。精准匹配环境，才能让 php artisan serve 稳定运行。
