应使用官方脚本安装Composer 3.x：先brew install php@8.2并启用mbstring等扩展，再php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"后php composer-setup.php --install-dir=/usr/local/bin --filename=composer，最后composer create-project laravel/laravel blog --no-interaction并php artisan key:generate。
先确认系统和基础工具
macOS Sonoma（14.x）已原生支持 ARM64（M系列芯片）和 Intel 架构，但默认不带 PHP、Composer 或 Laravel。你不需要 XAMPP/MAMP，也不用手动编译 PHP——Homebrew 是最稳的起点。
打开终端，先检查是否已有 Homebrew：
brew --version
没输出？说明还没装。直接运行：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
安装完按提示执行 source ~/.zshrc（或 ~/.zprofile，取决于你的 shell），再输一次 brew --version 确认生效。
装 PHP 8.2+ 并启用必需扩展
Laravel 11 强制要求 PHP ≥ 8.2，且必须启用 mbstring、openssl、pdo、tokenizer、xml、curl、ctype、json —— 少一个，项目根本起不来。
推荐命令（自动安装最新稳定版 PHP 8.2）：
brew install php@8.2
安装后，Homebrew 会提示你把 PHP 加入 PATH。通常它已自动写入 ~/.zshrc，但建议手动验证：
echo $PATH | grep homebrew → 应看到类似 /opt/homebrew/bin（Apple Silicon）或 /usr/local/bin（Intel）
再执行：
php -v → 必须显示 PHP 8.2.x（不是 8.1 或更低）
php -m | grep -E "(mbstring|openssl|pdo|tokenizer|xml|curl)" → 每项都应有输出，不能漏
⚠️ 常见卡点：macOS 默认禁用 mbstring。若无输出，检查 php.ini 路径（用 php --ini 查），编辑对应文件，取消注释 extension=mbstring，保存后重启终端。
装 Composer 3.x（不是 2.x！）
Laravel 11 的依赖解析强制依赖 Composer 3，用 2.5.x 会卡在 “Resolving dependencies” 或报错 “Your requirements could not be resolved”。
别用 brew install composer（Homebrew 默认仍推 2.x）。请用官方一键安装：
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php --install-dir=/usr/local/bin --filename=composer
验证：
composer --version → 输出必须是 3.x
为加速国内安装，顺手换镜像：
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/
创建 Laravel 11 项目并启动
跳过全局 laravel/installer（易版本滞后、权限异常），直连 Composer 创建：
composer create-project laravel/laravel blog --no-interaction
⚠️ --no-interaction 是必须的。不加它，Laravel 11 初始化会静默失败：.env 空、APP_KEY 是占位符，后续所有加密功能（Session/CSRF）全崩。
进项目：
cd blog
立刻生成密钥：
php artisan key:generate
检查 .env 文件中 APP_URL=http://localhost:8000 是否正确（默认就是，一般不用改）。
启动服务：
php artisan serve
浏览器打开 http://localhost:8000 —— 看到 Laravel 欢迎页，说明路由已通，环境真正就绪。
? 补充：如需 HTTPS 或多项目快速切换，可后续装 Laravel Herd（官网 herd.laravel.com），比 Valet 更轻量、更适配 Sonoma。
