專案強制要求 PHP 5.3,但 Ubuntu 12.04 預設倉庫已升級至 PHP 5.4+。強制降級套件易引發依賴地獄,最乾淨的方案是從源碼編譯安裝指定版本。本文記錄完整編譯流程,供歷史專案維護參考。
# Apache 2.2
sudo apt-get install apache2 -y
# MySQL 5.5
sudo apt-get install mysql-server-5.5 -y
# 編譯基礎工具
sudo apt-get install gcc g++ autoconf build-essential -y
# PHP 5.3 常見擴展依賴庫
sudo apt-get install \
libxml2 libxml2-dev \
libevent-1.4-2 libevent-dev \
bzip2 libbz2-dev \
libcurl3-gnutls libcurl4-gnutls-dev \
libpng12-0 libpng12-dev \
libjpeg62 libjpeg62-dev \
libfreetype6 libfreetype6-dev \
libmcrypt4 libmcrypt-dev \
zlib1g-dev \
libtidy-dev \
libmysqlclient-dev -y
注意: Ubuntu 12.04 套件名稱含版本號(如 libpng12),較新版本系統請調整為對應套件(如 libpng-dev)。
# 取得源碼
wget https://museum.php.net/php5/php-5.3.29.tar.gz
tar zxf php-5.3.29.tar.gz
cd php-5.3.29
# 配置編譯參數
./configure \
--prefix=/usr/local/php \
--with-mcrypt \
--with-gettext \
--with-mysql \
--with-gd \
--with-jpeg-dir \
--with-png-dir \
--with-curl \
--with-freetype-dir \
--enable-gd-native-ttf \
--enable-mbstring \
--enable-sockets \
--with-pdo-mysql \
--enable-fpm \
--with-zlib \
--enable-zip \
--with-bz2 \
--enable-bcmath \
--with-tidy \
--with-fpm-user=daemon \
--with-fpm-group=daemon
# 編譯安裝(視機器效能需 10-30 分鐘)
sudo make
sudo make install
--enable-fpm:啟用 PHP-FPM 進程管理器(生產環境推薦)--with-mysql --with-pdo-mysql:雙重支援舊版 mysql_* 與 PDO--enable-gd-native-ttf:使用 FreeType 字體渲染 TrueType 字體--with-fpm-user=daemon:指定 FPM 運行用戶(生產環境建議建立專用 www-data 用戶)sudo apt-get install php5-cli php5-dev
這會安裝系統預設版 PHP CLI(5.4+),與手動編譯的 5.3 共存無衝突,提供 phpize 等擴展開發工具。
sudo apt-get install libapache2-mod-php5
此套件會編譯 Apache 模組載入系統 PHP。若需使用自編譯 PHP 5.3,需手動編譯 php5_module 或改用 PHP-FPM + FastCGI(推薦)。
# 複製配置模板
cp /usr/local/php/etc/php-fpm.conf.default /usr/local/php/etc/php-fpm.conf
cp /usr/local/php/etc/php-fpm.d/www.conf.default /usr/local/php/etc/php-fpm.d/www.conf
# 編輯 www.conf 監聽端口
# listen = 127.0.0.1:9000
# 啟動測試
/usr/local/php/sbin/php-fpm
| 錯誤現象 | 原因 | 解決方案 |
|---|---|---|
| configure: error: xml2-config not found | 缺 libxml2-dev | sudo apt-get install libxml2-dev |
| configure: error: Cannot find libmysqlclient | MySQL 開發庫缺失 | sudo apt-get install libmysqlclient-dev |
| make: *** [ext/gd/gd.o] Error 1 | GD 庫版本不符或缺 freetype | 確認 libfreetype6-dev 已安裝,指定 --with-freetype-dir |
| undefined reference to `libiconv_open' | iconv 庫連結問題 | LDFLAGS="-liconv" ./configure ... 或安裝 libiconv |
/usr/local/php/bin/php -v
# 輸出應包含 PHP 5.3.29
/usr/local/php/bin/php -m | grep -E 'mysql|gd|mbstring|curl|fpm'
# 確認核心擴展已載入
PHP 5.3 於 2014 年停止維護,存在已知安全漏洞。僅建議用於無法升級的舊專案維護,且必須:
本文配置參數經實測可在 Ubuntu 12.04 成功編譯,新版 Ubuntu(18.04+)編譯 PHP 5.3 會遇到 OpenSSL 1.1+ 不相容問題,需額外打補丁或降級 OpenSSL,不建議嘗試。