前言
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 的包管理器。如果还没装,在终端里执行:~/.zprofile)。如果是手动追加,请重新加载配置。
安装 PHP
1
安装最新版 PHP
Homebrew 的
php formula 始终指向最新稳定版。Laravel 13 需要 PHP 8.3 或以上。2
确认版本
PHP 8.3.x 或以上即成功。3
(可选)使用特定版本
要管理多个 PHP 版本时,安装带版本号的 formula。通过 确认当前链接的版本。
brew link 切换版本。安装 Composer
1
安装 Composer
可以直接通过 Homebrew 安装。
2
确认版本
3
设置全局安装的路径
为了能使用通过 使配置生效:
composer global require 安装的包(如 Laravel installer),把 ~/.composer/vendor/bin 加入 PATH。在 ~/.zshrc(或 ~/.bashrc)追加:安装 nvm
Node.js 用 nvm(Node Version Manager)按用户级别安装。无需root 权限就能管理,和使用全局 npm 包的 AI 工具、CLI 兼容性也更好。
1
安装 nvm
最新的安装脚本可以在 nvm 的 GitHub 仓库 查看。
2
在 shell 配置里追加
安装脚本会自动向 使配置生效:
~/.zshrc(或 ~/.bashrc)追加下面几行。如果没有追加,请手动加上。3
确认安装
安装 Node.js
1
安装 LTS 版本
2
设为默认
让新终端会话也自动使用它,设置默认版本。
3
确认版本
验证 Laravel 安装
1
安装 Laravel installer
2
创建新项目
3
启动开发服务器
http://localhost:8000,看到 Laravel 欢迎页就完成了。和 Herd 的取舍
需要与团队开发或 CI 环境保持一致,或者要频繁在多个 PHP 版本间切换时,Homebrew 手动搭建更合适。