一、核心編譯參數分類詳解
1. 安裝路徑與基礎配置
| 參數 | 說明 | 典型值 |
--prefix | PHP 安裝根目錄 | /usr/local/php |
--with-config-file-path | php.ini 搜尋路徑 | /usr/local/php/etc |
--with-apxs2 | Apache 模塊模式(需 Apache 啟用 mod_so) | /usr/local/apache/bin/apxs |
2. 數據庫擴展
| 參數 | 說明 | 依賴庫 |
--with-mysqli | MySQL 改進版擴展,支持預處理、事務、存儲過程 | MySQL client lib |
--with-pdo-mysql | PDO MySQL 驅動(推薦:統一接口、高併發、易回收) | MySQL client lib |
--with-mysql-sock | 指定 mysql.sock 路徑,避免連接失敗 | /tmp/mysql.sock |
--with-pgsql | PostgreSQL 支持 | libpq |
--with-sqlite3 | SQLite3 支持 | libsqlite3 |
3. 圖形圖像處理
| 參數 | 說明 | 依賴關係 |
--with-gd | GD 庫核心支持 | 基礎 |
--with-jpeg-dir | JPEG 支持 | 需 libjpeg |
--with-png-dir | PNG 支持 | 需 libpng + zlib |
--with-freetype-dir | FreeType 字體渲染 | 需 freetype2 |
--enable-gd-native-ttf | TrueType 字體原生支持 | 需 freetype |
--with-webp-dir | WebP 格式支持 | 需 libwebp |
4. 加密與壓縮
| 參數 | 說明 | 依賴庫 |
--with-openssl | OpenSSL 加密傳輸、證書操作 | openssl-devel |
--with-mhash | Mhash 哈希算法 | libmhash |
--with-mcrypt | Mcrypt 加密算法(PHP 7.2+ 棄用,改用 Sodium) | libmcrypt |
--with-zlib | Zlib 壓縮(HTTP 壓縮、gz* 函數) | zlib-devel |
--with-bz2 | Bzip2 壓縮 | bzip2-devel |
5. 國際化與字符處理
| 參數 | 說明 |
--enable-mbstring | 多字節字符串支持(中文必須) |
--with-iconv | 字符集轉換(通常內建,--without-iconv 可禁用) |
--with-gettext | GNU Gettext 國際化 |
--enable-intl | ICU 國際化擴展(PHP 5.3+,強烈推薦) |
6. 網絡與協議
| 參數 | 說明 |
--with-curl | cURL 客戶端(HTTP/HTTPS/FTP 等) |
--with-curlwrappers | 使用 cURL 打開 URL 流包裝器 |
--enable-sockets | Socket 底層網絡編程 |
--enable-ftp | FTP 客戶端支持 |
--enable-soap | SOAP Web Service |
--with-xmlrpc | XML-RPC 支持 |
7. 效能與調試
| 參數 | 說明 | 建議 |
--enable-opcache | Zend OPcache 字節碼緩存(PHP 5.5+ 內建) | 生產必開 |
--disable-debug | 關閉調試符號,減小體積、提速 | 生產必開 |
--disable-rpath | 禁用運行時庫搜尋路徑硬編碼 | 推薦開啟 |
--enable-inline-optimization | GCC 內聯優化 | 視編譯器支持 |
二、CGI/FPM 部署模式專用參數
| 參數 | 適用模式 | 說明 |
--enable-fpm | PHP-FPM | 啟用 FPM 進程管理器(PHP 5.3.3+ 內建) |
--enable-fastcgi | FastCGI | 啟用 FastCGI SAPI |
--enable-force-cgi-redirect | CGI | 安全重定向檢查 |
互斥說明:--with-apxs2(Apache 模塊)與 --enable-fpm/fastcgi 不能同時使用,三選一。
三、依賴庫安裝順序與關鍵提示
- 基礎庫優先:libxml2 → zlib → openssl → pcre
- 圖形庫鏈:freetype → libpng → libjpeg → gd
- 數據庫客戶端:MySQL/PostgreSQL 開發包安裝後再編譯 PHP
- PCRE 版本:PHP 7.3+ 需 PCRE 8.32+,建議使用系統包管理器安裝
pcre-devel
--with-libxml-dir、--with-openssl-dir 等 --with-xxx-dir 參數指向庫安裝根目錄(含 include/lib 子目錄)
四、生產環境編譯策略建議
最小化原則
只編譯業務必需的擴展,減小攻擊面、降低記憶體佔用、加快啟動速度。
推薦核心配置模板
./configure \
--prefix=/usr/local/php \
--with-config-file-path=/usr/local/php/etc \
--with-config-file-scan-dir=/usr/local/php/etc/php.d \
--enable-fpm \
--with-fpm-user=www --with-fpm-group=www \
--enable-mysqlnd \
--with-mysqli=mysqlnd \
--with-pdo-mysql=mysqlnd \
--with-iconv-dir \
--with-freetype-dir \
--with-jpeg-dir \
--with-png-dir \
--with-zlib-dir \
--with-libxml-dir \
--enable-xml \
--disable-rpath \
--enable-bcmath \
--enable-shmop \
--enable-sysvsem \
--enable-inline-optimization \
--with-curl \
--enable-mbregex \
--enable-mbstring \
--enable-intl \
--enable-pcntl \
--enable-sockets \
--with-xmlrpc \
--enable-zip \
--enable-soap \
--enable-opcache \
--disable-debug \
--disable-fileinfo # 視業務需要,fileinfo 較耗內存
關鍵避坑指南
- ❌ 不要開啟
--enable-magic-quotes(PHP 5.4+ 已移除,極不推薦)
- ❌ 不要開啟
session.auto_start(破壞對象序列化)
- ❌ 避免 同時編譯多個 Opcode 緩存(xcache/apcu/opcache 三選一)
- ✅ 獨立編譯:不同項目使用不同 PHP 版本/擴展組合,避免「大而全」導致依賴地獄
- ✅ 壓測調優:FPM pm.max_children、pm.start_servers、pm.min_spare_servers 必須壓測調優
- ✅ 安全加固:編譯後關閉
expose_php、display_errors、限制 disable_functions
五、擴展安裝方式對比
| 方式 | 優點 | 缺點 | 適用場景 |
| 內建編譯 (--with-xxx) | 效能最佳、無依賴問題 | 升級需重編譯 PHP | 核心高頻擴展 |
| 共享擴展 (--enable-xxx=shared) | 獨立 .so 文件、可動態加載 | 略微效能損耗、需管理 extension_dir | 可選/實驗性擴展 |
| PECL 安裝 (pecl install xxx) | 不重編譯 PHP、版本獨立 | 需 phpize、依賴編譯工具鏈 | 第三方/新版擴展 |
合理的編譯配置是 PHP 高效能穩定運行的基石。建議建立標準化編譯腳本,納入版本控制,實現基礎設施即代碼。