PHPize 擴展模塊編譯安裝完整指南

phpize 是 PHP 源碼自帶的腳本，用於為**已安裝的 PHP** 構建擴展模塊 (`.so`)，無需重新編譯 PHP 本體。掌握其流程，能讓你快速集成 memcached、redis、swoole、imagick 等第三方擴展，或開發自定義 C 擴展。

一、核心原理

• phpize 讀取當前 PHP 的 php-config 獲取編譯參數 (include 路徑、擴展目錄、Zend API 版本等)。
• 在擴展源碼目錄生成 configure、Makefile.in 等構建文件。
• 隨後 ./configure --with-php-config=...、make、make install 產出 `.so` 並自動複製到 extension_dir。
• 最後在 php.ini 添加 extension=.so 生效。

二、標準安裝流程 (以 memcached 為例)

# 1. 下載並解壓擴展源碼
wget https://pecl.php.net/get/memcached-3.2.0.tgz
tar -xzf memcached-3.2.0.tgz
cd memcached-3.2.0

# 2. 執行 phpize (必須在擴展源碼根目錄)
/usr/local/php/bin/phpize
# 輸出示例：
# Configuring for:
# PHP Api Version:         20190902
# Zend Module Api No:      20190902
# Zend Extension Api No:   320190902

# 3. 配置編譯選項 (指定 php-config 路徑)
./configure --with-php-config=/usr/local/php/bin/php-config \
            --enable-memcached-json \
            --with-libmemcached-dir=/usr/local/libmemcached

# 4. 編譯安裝
make -j$(nproc) && make install
# 成功輸出：Installing shared extensions: /usr/local/php/lib/php/extensions/no-debug-non-zts-20190902/

# 5. 啟用擴展
echo "extension=memcached.so" >> /usr/local/php/etc/php.ini
# 或建議：echo "extension=memcached.so" > /usr/local/php/etc/php.d/10-memcached.ini

# 6. 重啟 PHP-FPM 生效
systemctl reload php-fpm

# 7. 驗證
php -m | grep memcached
php -r "new Memcached(); echo 'OK';"

三、常見錯誤與解決方案

四、進階場景

1. 多 PHP 版本共存環境

# PHP 7.4
/opt/php/7.4/bin/phpize
./configure --with-php-config=/opt/php/7.4/bin/php-config
make install

# PHP 8.1
/opt/php/8.1/bin/phpize
./configure --with-php-config=/opt/php/8.1/bin/php-config
make clean && make install

每個版本獨立編譯，產出對應 API 版本的 `.so`，互不干擾。

2. 靜態編譯進 PHP (而非共享模塊)

# 在 PHP 源碼目錄
cd /usr/src/php-8.1.0
./configure --enable-memcached=shared ... # shared=動態模塊
# 或
./configure --enable-memcached ...        # 靜態編譯進 php 二進制
make && make install

靜態編譯無需 phpize，但升級 PHP 需重新編譯整體。

3. 自定義擴展開發骨架

# 使用 PHP 官方骨架生成器
/opt/php/8.1/bin/phpize
./configure --enable-myext
# 會生成 myext.c、php_myext.h、config.m4 等模板
# 按照 PHP 內核 API 編寫邏輯，再 make install

五、驗證清單 (上線前必檢)

1. php -m | grep 顯示模塊名
2. php --ri 顯示模塊詳細信息 (版本、編譯選項、INI 設置)
3. php -r "var_dump(extension_loaded(''));" 返回 bool(true)
4. 編寫一個最小業務測試腳本跑通核心功能
5. 檢查 php-fpm 錯誤日誌無 PHP Warning: Module '' already loaded

六、容器化構建最佳實踐 (Dockerfile)

FROM php:8.1-fpm

# 安裝系統依賴
RUN apt-get update && apt-get install -y \
    libmemcached-dev zlib1g-dev libzip-dev \
    && rm -rf /var/lib/apt/lists/*

# 安裝 PECL 擴展 (自動處理 phpize/configure/make/install)
RUN pecl install memcached-3.2.0 redis-5.3.7 \
    && docker-php-ext-enable memcached redis

# 或手動編譯非 PECL 擴展
# COPY ./swoole-src /tmp/swoole
# RUN cd /tmp/swoole && phpize && ./configure --enable-openssl --enable-http2 && make -j$(nproc) && make install \
#     && docker-php-ext-enable swoole

優勢：docker-php-ext-enable 自動生成 .ini、處理依賴順序、清理構建緩存，鏡像體積最小化。

1. 上一篇文章： PHP + jQuery 實現中國地圖數據可視化交互展示
2. 下一篇文章： PHP 安裝 Xdebug 擴展完整指南

PHP 相關知識

電商系統商品屬性與規格建模設計

核心挑戰 商品屬性多樣性（如手機：顏色/內存/版本；服裝：尺

PHP 易忘核心知識點速查手冊：常量、引入、變數作用域與 MySQL 編碼

1. 常量定義：define() vs const <

PHP 檔案上傳原理與安全實作完整指南

PHP 檔案上傳原理與安全實作完整指南 檔案上傳是 Web

Apache 虛擬主機配置實戰：單 IP 綁定多域名的兩種方案詳解

Apache 虛擬主機配置實戰：單 IP 綁定多域名的兩種方