Linux 下安裝 PHP Memcached 客戶端完整步驟（含 libmemcached 依賴）

本文記錄在 Linux（以 Ubuntu 為例）下編譯安裝 PHP Memcached 擴展的完整流程，包含底層依賴 libmemcached 的安裝、PHP 擴展編譯、服務重啟驗證。

前置準備

• 確保已安裝 phpize、gcc、make 等編譯工具。
• PHP 安裝路徑示例：/usr/local/php，請根據實際情況調整路徑。

步驟 1：安裝 libmemcached 客戶端庫

官網：libmemcached.org

wget -c https://launchpad.net/libmemcached/1.0/1.0.16/+download/libmemcached-1.0.16.tar.gz
# ⚠️ 切勿下載 1.0.17，有已知 Bug
tar -zxvf libmemcached-1.0.16.tar.gz
cd libmemcached-1.0.16
./configure --prefix=/usr/local/libmemcached --with-memcached
sudo make
sudo make install

步驟 2：安裝 PHP Memcached 擴展

PECL 官網：pecl.php.net/package/memcached

wget -c https://pecl.php.net/get/memcached-2.2.0b1.tgz
tar -zxvf memcached-2.2.0b1.tgz
cd memcached-2.2.0b1
sudo /usr/local/php/bin/phpize
./configure --enable-memcached \
    --with-php-config=/usr/local/php/bin/php-config \
    --with-libmemcached-dir=/usr/local/libmemcached \
    --disable-memcached-sasl
sudo make
sudo make install

關鍵參數說明：

• --with-php-config：指定 PHP 安裝路徑下的 php-config。
• --with-libmemcached-dir：指向步驟 1 安裝的前綴目錄。
• --disable-memcached-sasl：若無 SASL 需求建議禁用，避免依賴缺失報錯。

步驟 3：修改 php.ini 加載擴展

在 php.ini 中添加：

extension=memcached.so

步驟 4：重啟服務生效

sudo /etc/init.d/nginx restart
sudo /etc/init.d/php-fpm restart  # 或 systemctl restart php-fpm

步驟 5：驗證安裝

創建 phpinfo.php 訪問，搜索 memcached 區塊，出現版本信息、libmemcached version 等即成功。

常見問題排查

• configure 報錯找不到 libmemcached：檢查 --with-libmemcached-dir 路徑是否為 make install 後的前綴目錄（含 include、lib 子目錄）。
• phpize 不存在：安裝 php-dev / php-devel 包。
• 啟動報 undefined symbol：多為 libmemcached 版本不匹配，建議嚴格使用 1.0.16。