前言
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 手動建構較合適。