Laravel 团队为新手准备了 Herd 和 php.new,而资深工程师更倾向于用包管理器分别管理各个工具。这样能自己掌控版本,也能轻松在多个项目间切换不同的 PHP 版本。
本指南使用 Homebrew 安装 PHP、Composer、Node.js(通过 nvm),直到 laravel new 能正常工作。
目标环境:macOS 13 Ventura 及以上。Apple Silicon(M1/M2/M3)和 Intel 都适用。
安装 Homebrew
Homebrew 是 macOS 的包管理器。如果还没装,在终端里执行:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
~/.zprofile)。如果是手动追加,请重新加载配置。
eval "$(/opt/homebrew/bin/brew shellenv)"
安装 PHP
安装最新版 PHP
Homebrew 的 php formula 始终指向最新稳定版。Laravel 13 需要 PHP 8.3 或以上。 (可选)使用特定版本
要管理多个 PHP 版本时,安装带版本号的 formula。通过 brew link 切换版本。确认当前链接的版本。
安装 Composer
设置全局安装的路径
为了能使用通过 composer global require 安装的包(如 Laravel installer),把 ~/.composer/vendor/bin 加入 PATH。在 ~/.zshrc(或 ~/.bashrc)追加:export PATH="$HOME/.composer/vendor/bin:$PATH"
安装 nvm
Node.js 用 nvm(Node Version Manager)按用户级别安装。无需 root 权限就能管理,和使用全局 npm 包的 AI 工具、CLI 兼容性也更好。
安装 nvm
最新的安装脚本可以在 nvm 的 GitHub 仓库 查看。curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
在 shell 配置里追加
安装脚本会自动向 ~/.zshrc(或 ~/.bashrc)追加下面几行。如果没有追加,请手动加上。export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"
安装 Node.js
确认版本
node --version
npm --version
验证 Laravel 安装
安装 Laravel installer
composer global require laravel/installer
创建新项目
交互式安装会启动,可以选择启动套件、是否加入认证等。 启动开发服务器
cd my-app
php artisan serve
http://localhost:8000,看到 Laravel 欢迎页就完成了。
和 Herd 的取舍
| Homebrew 手动搭建 | Herd |
|---|
| 面向对象 | 想细粒度控制版本和配置的开发者 | 想快速开始的新手 / 个人开发者 |
| PHP 版本切换 | brew link 手动切换 | GUI 一键切换 |
| 本地域名 | 手动改 /etc/hosts | 自动配置 .test 域名 |
| 服务管理 | brew services | GUI 启停 |
| 可定制性 | 高 | 有限 |
