Mac上安装Laravel11需先用Homebrew装PHP 8.3、Composer 3.x并启用mbstring等扩展，再通过composer create-project创建项目。
Mac 上用 Homebrew 安装 Laravel 框架，核心不是直接“安装 Laravel”，而是配齐 PHP、Composer 和项目生成环境。Laravel 本身是通过 Composer 创建的项目，不是系统级软件包。
先装 Homebrew（如果还没装）
打开终端，运行：
- /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
- 安装完成后执行：source ~/.zshrc（Apple Silicon）或 source ~/.zprofile（Intel 或较新 macOS）
- 验证：brew --version 应有输出
安装并配置 PHP 8.2/8.3/8.4（Laravel 11 强制要求）
Laravel 11 不支持 PHP 8.1 及更低版本。推荐安装 PHP 8.3（当前最稳）：
- brew install php@8.3
- brew link --force php@8.3（确保 php 命令指向新版）
- 检查版本：php -v → 显示 PHP 8.3.x
- 确认必需扩展已启用：php -m | grep -E "(mbstring|openssl|pdo|tokenizer|xml|curl|ctype|json)" → 每项都应出现
- 若缺某项（如 mbstring），查 php.ini 路径：php --ini，编辑对应文件，取消注释 extension=mbstring 等行，保存后重启终端
安装 Composer 3.x（不是 2.x）
Laravel 11 依赖 Composer 3 的依赖解析能力，Homebrew 默认仍提供 Composer 2，必须用官方方式安装：
- 先清理可能存在的旧版：brew uninstall composer
- 下载并安装 Composer 3：
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://packagist.phpcomposer.com
创建 Laravel 11 项目
一切就绪后，用 Composer 初始化项目：
- composer create-project laravel/laravel blog --no-interaction
- 进入项目：cd blog
- 生成应用密钥：php artisan key:generate
- 启动开发服务器：php artisan serve → 访问 http://127.0.0.1:8000 即可看到欢迎页
不复杂但容易忽略：PHP 版本、Composer 大版本、扩展启用这三项任一出错，都会导致项目无法启动或依赖解析失败。
