萬盛學電腦網

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

Ubuntu 12.04 編譯安裝 PHP 5.3 開發環境完整實戰筆記

背景與動機

專案強制要求 PHP 5.3,但 Ubuntu 12.04 預設倉庫已升級至 PHP 5.4+。強制降級套件易引發依賴地獄,最乾淨的方案是從源碼編譯安裝指定版本。本文記錄完整編譯流程,供歷史專案維護參考。

系統環境

  • 作業系統:Ubuntu 12.04 LTS (Precise Pangolin) Server
  • 目標版本:PHP 5.3.29 (5.3 系列最終版)
  • Web 伺服器:Apache 2.2
  • 資料庫:MySQL 5.5

步驟 1:安裝基礎服務

# Apache 2.2
sudo apt-get install apache2 -y

# MySQL 5.5
sudo apt-get install mysql-server-5.5 -y

步驟 2:安裝編譯工具鏈與依賴庫

# 編譯基礎工具
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)。

步驟 3:下載並編譯 PHP 5.3.29

# 取得源碼
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 用戶)

步驟 4:安裝 CLI 與開發工具

sudo apt-get install php5-cli php5-dev

這會安裝系統預設版 PHP CLI(5.4+),與手動編譯的 5.3 共存無衝突,提供 phpize 等擴展開發工具。

步驟 5:整合 Apache 2.2

sudo apt-get install libapache2-mod-php5

此套件會編譯 Apache 模組載入系統 PHP。若需使用自編譯 PHP 5.3,需手動編譯 php5_module 或改用 PHP-FPM + FastCGI(推薦)。

步驟 6:配置 PHP-FPM(生產環境推薦)

# 複製配置模板
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-devsudo apt-get install libxml2-dev
configure: error: Cannot find libmysqlclientMySQL 開發庫缺失sudo apt-get install libmysqlclient-dev
make: *** [ext/gd/gd.o] Error 1GD 庫版本不符或缺 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 年停止維護,存在已知安全漏洞。僅建議用於無法升級的舊專案維護,且必須:

  1. 運行於隔離網路環境
  2. 部署 WAF(如 ModSecurity)
  3. 制定遷移計畫至 PHP 7.4+/8.x

本文配置參數經實測可在 Ubuntu 12.04 成功編譯,新版 Ubuntu(18.04+)編譯 PHP 5.3 會遇到 OpenSSL 1.1+ 不相容問題,需額外打補丁或降級 OpenSSL,不建議嘗試。

copyright © 萬盛學電腦網 all rights reserved