Laravel 12 安装成功需满足 PHP ≥ 8.2 且 mbstring、openssl、pdo 等 11 项扩展真实加载；必须用 Composer 3.x、配置阿里云镜像、创建时指定 ^12.0 版本约束，并执行 key:generate 和 config:clear。
要在本地或服务器上成功安装 Laravel 12，必须确保 PHP 版本 ≥ 8.2 且所有必需扩展真实加载——只装不启用、或版本错配都会导致 composer create-project 中途崩溃、artisan 命令报 Class not found、甚至首页白屏无错误提示。
确认 PHP 版本与运行时扩展状态
打开终端，执行：
php -v
输出必须为 PHP 8.2.x、8.3.x 或 8.4.x（Laravel 12 官方要求最低 8.2，但 8.3+ 更稳）。
紧接着运行：
php -m | grep -E "(mbstring|openssl|pdo|tokenizer|xml|ctype|json|bcmath|fileinfo|zip|curl)"
每一项都必须有输出；缺任何一项，php artisan serve 启动后立即报错或路由完全不响应。
注意：macOS 用 Homebrew 安装 php@8.4 后，必须执行 brew link php@8.4 并把 /opt/homebrew/bin 加入 $PATH，否则终端里调用的仍是系统旧版 PHP。
立即学习“PHP免费学习笔记（深入）”；
补全缺失的 PHP 扩展（按系统操作）
方法一：Ubuntu/Debian 系统
sudo apt update → sudo apt install php8.3-mbstring php8.3-xml php8.3-zip php8.3-curl php8.3-tokenizer php8.3-bcmath php8.3-fileinfo php8.3-opcache
方法二：CentOS/RHEL 8+
sudo dnf install php-mbstring php-xml php-zip php-curl php-tokenizer php-bcmath php-fileinfo php-opcache
方法三：macOS（Homebrew）
brew install php@8.4 → brew link php@8.4 → 验证 php --ini 显示的配置文件路径，打开该 php.ini，检查 extension= 行是否全部取消注释（如 extension=mbstring），改完必须重启终端再验证。
Windows 用户常见坑：【php.ini 中 extension=openssl 和 extension=mbstring 仍被分号注释】——XAMPP/WAMP/Laragon 控制面板勾选了扩展，但实际生效的是 php.ini 文件里的文本开关，不手动删掉前面的 ; 就等于没开。
用 Composer 创建 Laravel 12 项目
第一步：确保 Composer 是 3.x 版本
运行 composer --version，输出形如 Composer version 3.5.6；若显示 2.x，必须卸载重装最新版。
第二步：全局配置阿里云镜像源
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
第三步：创建项目并锁定兼容版本
composer create-project laravel/laravel:^12.0 myapp --no-interaction --prefer-dist
不加 ^12.0 可能拉到未正式发布的 dev 分支，触发 PHP 8.4-only 依赖而失败。
第四步：进入项目并生成密钥
cd myapp → php artisan key:generate
第五步：清空配置缓存防止 .env 未生效
php artisan config:clear → php artisan cache:clear
