macOS 多 PHP 版本快速切換指南：Homebrew + php-version 實戰

前言：為什麼需要多版本切換？

PHP 從 5.6 到 8.x 差異巨大，舊專案常需舊版本，新專案用新版本。手動修改 PATH、重編譯極其痛苦。Homebrew + php-version 提供秒級切換體驗。

前置條件

• ✅ macOS 系統
• ✅ 已安裝 Homebrew（/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"）
• ✅ 所有 PHP 版本必須由 Homebrew 安裝

三步驟完成配置

1. 安裝多版本 PHP

brew install php@5.6
brew install php@7.0
brew install php@7.4
brew install php@8.1
# 依需求安裝，Homebrew 會自動處理依賴

2. 安裝切換工具 php-version

brew install php-version
# 關鍵：將初始化腳本加入 shell 配置
echo 'source $(brew --prefix php-version)/php-version.sh' >> ~/.zshrc  # 或 ~/.bash_profile
source ~/.zshrc

3. 實戰切換

# 查看已安裝版本
php-version
# 輸出範例：
#   5.6.40
#   7.0.33
# * 7.4.33  (當前使用中)
#   8.1.12

# 切換版本（即時生效，無需重啟終端）
php-version 5.6.40
php-version 8.1.12

原理說明

php-version 透過修改 Shell 環境變數 PATH，將對應版本的 bin 目錄優先放入，並更新 PHP_INI_SCAN_DIR 等相關變數，實現無縫切換。

常見問題與解決

進階替代方案

• Docker：專案級隔離，docker-compose.yml 指定版本，最推薦團隊協作
• Laravel Herd：圖形化管理、自動配置 Nginx、支援多版本並行，Mac 專用神器
• asdf / mise：通用版本管理器，支援 Node、Python、Go 等多語言

總結

Homebrew + php-version 是 macOS 上最輕量、零配置、即時生效的 PHP 多版本切換方案。適合單機開發、快速驗證相容性。團隊專案建議改用 Docker 或 Herd 確保環境一致性。