macOS 預裝了 PHP,但只有最基本的環境,缺少 Redis、Memcache、MongoDB、Xdebug 這些開發時常用的擴充。以下整理完整的安裝流程,包含先決條件、pecl 管理器、以及需要自行編譯的模組。

步驟一:安裝開發環境
編譯 PHP 擴充需要 Xcode 的指令列工具。若尚未安裝,先執行:
xcode-select --install
步驟二:安裝 PECL 擴充管理器
PECL 是 PHP 的擴充套件管理工具,裝好它之後大部分擴充都能一行指令搞定:
cd /usr/lib/php sudo php install-pear-nozlib.phar
步驟三:安裝常用擴充
sudo pecl install redis sudo pecl install memcache sudo pecl install mongo sudo pecl install xdebug
步驟四:在 php.ini 中啟用
裝好只是放到磁碟上,還必須在設定檔中載入才會生效:
extension=memcache.so extension=mongo.so extension=redis.so zend_extension=xdebug.so
注意 Xdebug 用的是 zend_extension 而非 extension,因為它屬於 Zend 引擎層級的擴充。這個差別寫錯會導致模組載入失敗。
步驟五:編譯安裝 XCache
XCache 不在 PECL 的安裝路徑中,需手動下載編譯(版本請依官網最新公告調整):
tar xvf xcache-3.2.0.tar cd xcache-3.2.0 phpize ./configure make sudo make install
接著在 php.ini 中加入設定:
[xcache] xcache.size = 128M xcache.var_size = 8M xcache.var_count = 1 xcache.var_slots = 8K xcache.var_ttl = 0 xcache.var_maxttl = 0 xcache.var_gc_interval = 300 xcache.optimizer = Off
步驟六:編譯 mcrypt
macOS 自帶的 PHP 不含 mcrypt,必須下載「與系統 PHP 相同版本」的源碼包,只編譯這個模組。先到 PHP 官網的歸檔頁找到對應版本(例如 php-5.5.14):
tar zxvf php-5.5.14.tar.gz cd php-5.5.14/ext/mcrypt/ phpize ./configure make sudo make install
然後在 php.ini 中加入:
extension=mcrypt.so
版本必須對得上——這是這一步最容易失敗的地方。若系統 PHP 是 5.5.14 而你去編譯 7.x 的源碼,模組會因 ABI 不符而無法載入。
步驟七:啟用 OPcache 加速
zend_extension=opcache.so [opcache] ; 是否啟用 OPcache opcache.enable=0 ; 是否為 CLI 版本的 PHP 啟用 opcache.enable_cli=0
幾點實務提醒
第一,改完 php.ini 後需重啟 Apache 或 php-fpm 才會生效,可用 php -m 確認模組是否載入成功。第二,macOS 系統的 /usr/bin/php 屬於系統元件,新版本已受 SIP 保護,直接在其目錄下操作可能失敗。第三,也是最重要的一點——上述流程反映的是較早期的 macOS 環境;macOS 10.14 之後已不再預裝 PHP,因此更實際的做法是用 Homebrew 安裝(brew install php),擴充模組也有現成的 formula(brew install php-redis 等),不必再手動 phpize 與 configure,版本切換也方便得多。