# 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
| 錯誤信息 | 缺失庫 | CentOS/RHEL (yum/dnf) | Debian/Ubuntu (apt) | Alpine (apk) |
|---|---|---|---|---|
| libevent >= 1.4.11 not found | libevent | libevent-devel | libevent-dev | libevent-dev |
| Please reinstall the mysql distribution | MySQL 客戶端開發庫 | mysql-devel / mariadb-devel | libmysqlclient-dev / default-libmysqlclient-dev | mariadb-dev |
| XML configuration could not be found | libxml2 | libxml2-devel | libxml2-dev | libxml2-dev |
| No curses/termcap library found | ncurses | ncurses-devel | libncurses5-dev / libncursesw5-dev | ncurses-dev |
| xml2-config not found | libxml2 | libxml2-devel | libxml2-dev | libxml2-dev |
| Cannot find OpenSSL's <evp.h> | OpenSSL | openssl-devel | libssl-dev | openssl-dev |
| Please reinstall the libcurl distribution | libcurl | libcurl-devel | libcurl4-openssl-dev | curl-dev |
| Cannot find ldap.h | OpenLDAP | openldap-devel | libldap2-dev | openldap-dev |
| libjpeg.(a|so) not found | libjpeg | libjpeg-turbo-devel | libjpeg-dev | libjpeg-turbo-dev |
| libpng.(a|so) not found | libpng | libpng-devel | libpng-dev | libpng-dev |
| freetype.h not found | FreeType | freetype-devel | libfreetype6-dev | freetype-dev |
| cannot find output from lex | flex | flex | flex | flex |
| mod_deflate prerequisite failures | zlib, OpenSSL | zlib-devel openssl-devel | zlib1g-dev libssl-dev | zlib-dev openssl-dev |
| Unable to locate gmp.h | GMP | gmp-devel | libgmp-dev | gmp-dev |
| Cannot find MySQL header files under /usr | MySQL 開發包 | mysql-devel / mariadb-devel | libmysqlclient-dev | mariadb-dev |
| ODBC header file sqlext.h not found | unixODBC | unixODBC-devel | unixodbc-dev | unixodbc-dev |
| Cannot find pspell | aspell/pspell | aspell-devel | libaspell-dev | aspell-dev |
| mcrypt.h not found | libmcrypt | libmcrypt-devel | libmcrypt-dev | libmcrypt-dev |
| snmp.h not found | net-snmp | net-snmp-devel | libsnmp-dev | net-snmp-dev |
| /usr/bin/ld: cannot find -lltdl | libtool | libtool-ltdl-devel | libltdl-dev | libtool-dev |
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
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
./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
通常是 libiconv 衝突:
make ZEND_EXTRA_LIBS='-liconv'
# 或預先安裝 libiconv 並指定
./configure --with-iconv=/usr/local/libiconv ...
yum install autoconf -y # CentOS
apt-get install autoconf -y # Ubuntu/Debian
必須在擴展源碼頂層目錄運行 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
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 # 測試配置語法
yum install php83-php-fpm php83-php-mysqlnd ... 獲取最新穩定版。docker run -d --name php-fpm -v /www:/var/www/html php:8.3-fpm,零編譯煩惱,環境一致性最佳。