PHP 編譯安裝常見 configure 錯誤與 yum 解決方案速查表

PHP 編譯安裝常見 configure 錯誤與 yum 解決方案速查表

PHP 源碼編譯時 ./configure 階段頻繁報缺少開發庫頭文件。本文匯總高頻錯誤與對應 yum install *-devel 解決命令，覆蓋 XML、圖像、數據庫、加密、郵件、LDAP、ODBC、SNMP、XSLT 等常見依賴，適合 CentOS/RHEL 系統快速排查。

速查表

通用排查技巧

1. 查看 config.log：tail -50 config.log 定位具體缺失頭文件/庫路徑。
2. 搜尋文件：find /usr -name "xxx.h" 確認文件是否存在但路徑不在默認搜尋目錄。
3. 指定路徑：./configure --with-xxx-dir=/custom/path 強制指定庫目錄。
4. 安裝開發工具組：yum groupinstall "Development Tools" 確保 gcc、make、autoconf 等基礎工具齊全。
5. EPEL 源：yum install epel-release 獲取更多第三方庫包。

典型完整編譯參數示例

./configure \
--prefix=/usr/local/php \
--with-config-file-path=/usr/local/php/etc \
--enable-fpm \
--with-mysqli=mysqlnd \
--with-pdo-mysql=mysqlnd \
--with-iconv-dir \
--with-freetype-dir \
--with-jpeg-dir \
--with-png-dir \
--with-zlib \
--with-libxml-dir \
--enable-xml \
--disable-rpath \
--enable-bcmath \
--enable-shmop \
--enable-sysvsem \
--enable-inline-optimization \
--with-curl \
--enable-mbregex \
--enable-mbstring \
--with-mcrypt \
--enable-ftp \
--with-gd \
--enable-gd-native-ttf \
--with-openssl \
--with-mhash \
--enable-pcntl \
--enable-sockets \
--with-xmlrpc \
--enable-zip \
--enable-soap \
--with-gettext \
--enable-opcache \
--with-xsl \
--with-ldap \
--with-ldap-sasl

收藏此表，下次編譯 PHP 遇到 configure 報錯，一鍵 yum 解決，事半功倍。