萬盛學電腦網

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

PHP 源碼編譯安裝常見錯誤與依賴包解決方案大全

編譯前準備

# 1. 安裝編譯工具鏈
yum groupinstall "Development Tools" -y  # CentOS/RHEL
apt-get install build-essential -y       # Debian/Ubuntu

# 2. 下載 PHP 源碼
wget https://www.php.net/distributions/php-8.3.10.tar.gz
tar xzf php-8.3.10.tar.gz
cd php-8.3.10

高頻 configure 錯誤與對應開發包

錯誤信息缺失庫CentOS/RHEL (yum/dnf)Debian/Ubuntu (apt)Alpine (apk)
libevent >= 1.4.11 not foundlibeventlibevent-devellibevent-devlibevent-dev
Please reinstall the mysql distributionMySQL 客戶端開發庫mysql-devel / mariadb-devellibmysqlclient-dev / default-libmysqlclient-devmariadb-dev
XML configuration could not be foundlibxml2libxml2-devellibxml2-devlibxml2-dev
No curses/termcap library foundncursesncurses-devellibncurses5-dev / libncursesw5-devncurses-dev
xml2-config not foundlibxml2libxml2-devellibxml2-devlibxml2-dev
Cannot find OpenSSL's <evp.h>OpenSSLopenssl-devellibssl-devopenssl-dev
Please reinstall the libcurl distributionlibcurllibcurl-devellibcurl4-openssl-devcurl-dev
Cannot find ldap.hOpenLDAPopenldap-devellibldap2-devopenldap-dev
libjpeg.(a|so) not foundlibjpeglibjpeg-turbo-devellibjpeg-devlibjpeg-turbo-dev
libpng.(a|so) not foundlibpnglibpng-devellibpng-devlibpng-dev
freetype.h not foundFreeTypefreetype-devellibfreetype6-devfreetype-dev
cannot find output from lexflexflexflexflex
mod_deflate prerequisite failureszlib, OpenSSLzlib-devel openssl-develzlib1g-dev libssl-devzlib-dev openssl-dev
Unable to locate gmp.hGMPgmp-devellibgmp-devgmp-dev
Cannot find MySQL header files under /usrMySQL 開發包mysql-devel / mariadb-devellibmysqlclient-devmariadb-dev
ODBC header file sqlext.h not foundunixODBCunixODBC-develunixodbc-devunixodbc-dev
Cannot find pspellaspell/pspellaspell-devellibaspell-devaspell-dev
mcrypt.h not foundlibmcryptlibmcrypt-devellibmcrypt-devlibmcrypt-dev
snmp.h not foundnet-snmpnet-snmp-devellibsnmp-devnet-snmp-dev
/usr/bin/ld: cannot find -lltdllibtoollibtool-ltdl-devellibltdl-devlibtool-dev

一鍵安裝所有常用依賴(CentOS 7/8、RHEL、Rocky、AlmaLinux)

yum install -y \
    gcc gcc-c++ make autoconf automake libtool \
    libxml2-devel openssl-devel bzip2-devel libcurl-devel \
    libjpeg-turbo-devel libpng-devel freetype-devel \
    gmp-devel libmcrypt-devel readline-devel \
    libxslt-devel libzip-devel sqlite-devel \
    oniguruma-devel libicu-devel \
    mariadb-devel postgresql-devel \
    openldap-devel libevent-devel \
    ncurses-devel unixODBC-devel aspell-devel \
    net-snmp-devel libtool-ltdl-devel

一鍵安裝所有常用依賴(Ubuntu 20.04/22.04/24.04、Debian 11/12)

apt-get update && apt-get install -y \
    build-essential autoconf automake libtool pkg-config \
    libxml2-dev libssl-dev libbz2-dev libcurl4-openssl-dev \
    libjpeg-dev libpng-dev libfreetype6-dev \
    libgmp-dev libmcrypt-dev libreadline-dev \
    libxslt1-dev libzip-dev libsqlite3-dev \
    libonig-dev libicu-dev \
    default-libmysqlclient-dev libpq-dev \
    libldap2-dev libevent-dev \
    libncurses5-dev libncursesw5-dev unixodbc-dev libaspell-dev \
    libsnmp-dev libltdl-dev

經典編譯配置參數模板 (PHP 8.1+)

./configure \
    --prefix=/usr/local/php83 \
    --with-config-file-path=/usr/local/php83/etc \
    --with-config-file-scan-dir=/usr/local/php83/etc/conf.d \
    --enable-fpm \
    --with-fpm-user=www \
    --with-fpm-group=www \
    --enable-mysqlnd \
    --with-mysqli=mysqlnd \
    --with-pdo-mysql=mysqlnd \
    --with-pdo-pgsql \
    --with-iconv \
    --with-freetype \
    --with-jpeg \
    --with-zlib \
    --with-bz2 \
    --enable-gd \
    --enable-mbstring \
    --enable-xml \
    --enable-bcmath \
    --enable-sockets \
    --enable-intl \
    --enable-opcache \
    --enable-pcntl \
    --enable-ftp \
    --enable-exif \
    --with-curl \
    --with-openssl \
    --with-zip \
    --with-gettext \
    --with-mhash \
    --enable-soap \
    --enable-calendar \
    --enable-shmop \
    --enable-sysvsem \
    --enable-sysvshm \
    --enable-sysvmsg \
    --with-pear \
    --disable-short-tags \
    --disable-rpath

編譯與安裝

# 並行編譯加速 (根據 CPU 核心數調整 -j)
make -j$(nproc)

# 安裝
make install

# 複製配置文件
cp php.ini-production /usr/local/php83/etc/php.ini
cp /usr/local/php83/etc/php-fpm.conf.default /usr/local/php83/etc/php-fpm.conf
cp /usr/local/php83/etc/php-fpm.d/www.conf.default /usr/local/php83/etc/php-fpm.d/www.conf

# 創建軟鏈接方便調用
ln -sf /usr/local/php83/bin/php /usr/local/bin/php
ln -sf /usr/local/php83/bin/phpize /usr/local/bin/phpize
ln -sf /usr/local/php83/sbin/php-fpm /usr/local/sbin/php-fpm

特殊錯誤處理

1. make: *** [sapi/fpm/php-fpm] Error 1

通常是 libiconv 衝突:

make ZEND_EXTRA_LIBS='-liconv'
# 或預先安裝 libiconv 並指定
./configure --with-iconv=/usr/local/libiconv ...

2. phpize 報錯:Cannot find autoconf

yum install autoconf -y      # CentOS
apt-get install autoconf -y  # Ubuntu/Debian

3. phpize 報錯:Cannot find config.m4

必須在擴展源碼頂層目錄運行 phpize,而非 PHP 安裝目錄。

cd php-8.3.10/ext/gd
/usr/local/php83/bin/phpize
./configure --with-php-config=/usr/local/php83/bin/php-config
make && make install

4. 編譯 xcache/舊擴展報錯

PHP 7+ 已內建 OPcache,不再需要 xcache。如需兼容舊代碼,請遷移至 OPcache 配置。

驗證安裝

/usr/local/php83/bin/php -v
/usr/local/php83/bin/php -m | grep -E 'mysql|gd|curl|opcache|zip|intl'
/usr/local/php83/sbin/php-fpm -t  # 測試配置語法

生產環境建議:使用包管理器或 Docker

  • Remi 源: yum install php83-php-fpm php83-php-mysqlnd ... 獲取最新穩定版。
  • Docker 官方鏡像: docker run -d --name php-fpm -v /www:/var/www/html php:8.3-fpm,零編譯煩惱,環境一致性最佳。
  • 預編譯二進制: windows.php.net 提供 Windows 版;Linux 可用 GitHub Releases 的靜態編譯包。
copyright © 萬盛學電腦網 all rights reserved