萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 編譯參數完整中文手冊:核心模塊、擴展庫與生產環境優化建議

一、核心編譯參數分類詳解

1. 安裝路徑與基礎配置

參數說明典型值
--prefixPHP 安裝根目錄/usr/local/php
--with-config-file-pathphp.ini 搜尋路徑/usr/local/php/etc
--with-apxs2Apache 模塊模式(需 Apache 啟用 mod_so)/usr/local/apache/bin/apxs

2. 數據庫擴展

參數說明依賴庫
--with-mysqliMySQL 改進版擴展,支持預處理、事務、存儲過程MySQL client lib
--with-pdo-mysqlPDO MySQL 驅動(推薦:統一接口、高併發、易回收)MySQL client lib
--with-mysql-sock指定 mysql.sock 路徑,避免連接失敗/tmp/mysql.sock
--with-pgsqlPostgreSQL 支持libpq
--with-sqlite3SQLite3 支持libsqlite3

3. 圖形圖像處理

參數說明依賴關係
--with-gdGD 庫核心支持基礎
--with-jpeg-dirJPEG 支持需 libjpeg
--with-png-dirPNG 支持需 libpng + zlib
--with-freetype-dirFreeType 字體渲染需 freetype2
--enable-gd-native-ttfTrueType 字體原生支持需 freetype
--with-webp-dirWebP 格式支持需 libwebp

4. 加密與壓縮

參數說明依賴庫
--with-opensslOpenSSL 加密傳輸、證書操作openssl-devel
--with-mhashMhash 哈希算法libmhash
--with-mcryptMcrypt 加密算法(PHP 7.2+ 棄用,改用 Sodium)libmcrypt
--with-zlibZlib 壓縮(HTTP 壓縮、gz* 函數)zlib-devel
--with-bz2Bzip2 壓縮bzip2-devel

5. 國際化與字符處理

參數說明
--enable-mbstring多字節字符串支持(中文必須)
--with-iconv字符集轉換(通常內建,--without-iconv 可禁用)
--with-gettextGNU Gettext 國際化
--enable-intlICU 國際化擴展(PHP 5.3+,強烈推薦)

6. 網絡與協議

參數說明
--with-curlcURL 客戶端(HTTP/HTTPS/FTP 等)
--with-curlwrappers使用 cURL 打開 URL 流包裝器
--enable-socketsSocket 底層網絡編程
--enable-ftpFTP 客戶端支持
--enable-soapSOAP Web Service
--with-xmlrpcXML-RPC 支持

7. 效能與調試

參數說明建議
--enable-opcacheZend OPcache 字節碼緩存(PHP 5.5+ 內建)生產必開
--disable-debug關閉調試符號,減小體積、提速生產必開
--disable-rpath禁用運行時庫搜尋路徑硬編碼推薦開啟
--enable-inline-optimizationGCC 內聯優化視編譯器支持

二、CGI/FPM 部署模式專用參數

參數適用模式說明
--enable-fpmPHP-FPM啟用 FPM 進程管理器(PHP 5.3.3+ 內建)
--enable-fastcgiFastCGI啟用 FastCGI SAPI
--enable-force-cgi-redirectCGI安全重定向檢查

互斥說明:--with-apxs2(Apache 模塊)與 --enable-fpm/fastcgi 不能同時使用,三選一。

三、依賴庫安裝順序與關鍵提示

  1. 基礎庫優先:libxml2 → zlib → openssl → pcre
  2. 圖形庫鏈:freetype → libpng → libjpeg → gd
  3. 數據庫客戶端:MySQL/PostgreSQL 開發包安裝後再編譯 PHP
  4. PCRE 版本:PHP 7.3+ 需 PCRE 8.32+,建議使用系統包管理器安裝 pcre-devel
  5. --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 高效能穩定運行的基石。建議建立標準化編譯腳本,納入版本控制,實現基礎設施即代碼。

copyright © 萬盛學電腦網 all rights reserved