Skip to main content

前言

Laravel 團隊為初學者準備了 Herdphp.new,但資深工程師偏好用套件管理器分別管理各工具。可自行控制版本,也能輕易在多個專案中切換不同 PHP 版本。 本指南解說如何用 Homebrew 安裝 PHP、Composer、Node.js(透過 nvm),直到 laravel new 能運作。
對象環境:macOS 13 Ventura 以上。Apple Silicon(M1/M2/M3)與 Intel 皆支援。

安裝 Homebrew

Homebrew 是 macOS 用套件管理器。若尚未安裝,於終端機執行:
安裝後,Apple Silicon 上會自動在 shell 設定檔(如 ~/.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 手動建構較合適。
最後修改於 2026年8月2日