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 大版本、扩展启用这三项任一出错,都会导致项目无法启动或依赖解析失败。











