也紀念我們永遠的朋友 李士傑先生（Shih-Chieh Ilya Li）。
phpfarm - install multiple versions of PHP beside each other
phpfarm - install multiple versions of PHP beside each other
前言
有時候在網路下載現成的 PHP 論壇或其他圖片管理軟體，例如 phpBB 或 Gallery，安裝後卻出現很多錯誤訊息。初學者面對這種情形一定非常困擾，心中猜想到底是該軟體的問題，還是自己安裝步驟不正確。
身為 PHP 軟體工程師，需要注意 PHP 各版本之間的差異，例如函式是否已經被官方移除等。這些改變都會造成開發者或使用者的困擾。因此，在每次釋出新版軟體前，應該進行 PHP 各版本的相容性測試，有以下兩種作法：
- 使用不同台機器測試不同 PHP 版本。
- 在同一台機器上安裝多個不同的 PHP 版本。
第 1 種方式需要很多硬體資源和安裝時間，除此之外，不同的機器應部署相同的測試環境。相對來說，第 2 種作法的好處顯而易見，除了可以一次解決軟體相依性的問題，執行跨版本的測試也比較容易。
本篇文章將以 phpfarm 介面解決上述遇到的問題。後續的指令及操作環境皆於 Ubuntu 發行套件下進行。
安裝 phpfarm
01. 下載 phpfarm 專案
I. 從 SourceForge 網站下載
phpfarm 可以從 SourceForge 下載，專案網址為：
https://sourceforge.net/projects/phpfarm
II. 透過 git 下載
請先確認系統已正確安裝 git，若無則用下列指令進行安裝：
$ sudo apt-get install git
接著使用 git 的指令下載 phpfarm 專案：
$ git clone git://git.code.sf.net/p/phpfarm/code phpfarm
02. 進行編譯
phpfarm 專案目錄中，主要有 "inst" 及 "src" 兩個目錄。"inst" 目錄存放編譯過的執行檔，而 "src" 則存放編譯需要的 script 腳本語言及原始碼。
I. 簡易編譯
先介紹最簡單的編譯方式：
$ cd phpfarm/src
$ ./compile 5.3.2
phpfarm 會從 php.net 官方網站中，下載 PHP 5.3.2 版本的原始檔進行編譯。如果編譯過程沒有發生錯誤，則可以在 " inst/bin/ " 目錄下找到 "php-5.3.2" 的目錄及相關檔案。
接著使用下列指令檢查 PHP 版本（需注意安裝路徑）：
$ ./inst/bin/php-5.3.2 -v
PHP 5.3.2 (cli) (built: Oct 22 2011 18:38:53) (DEBUG)
Copyright (c) 1997-2010 The PHP Group
Zend Engine v2.3.0, Copyright (c) 1998-2010 Zend Technologies
II. 進階編譯
上述簡易編譯 PHP 版本的功能，可能無法符合某些人的需求。例如，編譯後的 PHP 版本，預設並沒有支援 MySQL 相關函式，因此必須在 phpfarm 安裝執行檔中手動增修。
官方網站似乎沒有增修教學，但實際上可以在 "src/compile.sh" 這個檔案中找到相關設定。執行 "./compile 5.3.2" 時，會先載入 "src/options.sh"，不同版本可以指定不同的設定檔。
因此，如果要編譯 php 5.3.2，則需要在 "src" 目錄下，新增名為 "custon-options-5.3.2.sh" 的檔案，內容範例如下：
configoptions="\
--enable-bcmath \
--enable-calendar \
--enable-exif \
--enable-ftp \
--with-mysql \
--with-mysqli \
--enable-mbstring \
--enable-pcntl \
--enable-soap \
--enable-sockets \
--enable-sqlite-utf8 \
--enable-wddx \
--enable-zip \
--with-zlib \
--with-gettext \
也可以任意更改版本編號來編譯不同版本，檔案架構如下：
# 原始設定檔
$ custom-options.sh
# PHP 5 設定檔
$ custom-options-5.sh
# PHP 5.3 設定檔
$ custom-options-5.3.sh
# PHP 5.3.1 設定檔
$ custom-options-5.3.1.sh
03. 開始安裝
如果希望在任何地方都可以使用 phpfarm 編譯後的 PHP 版本，必須設定環境變數。
假設完整的 php-5.3.2 路徑為 "/otp/phpfarm/inst/bin/php-5.3.2"（此路徑依據先前下載及編譯 phpfarm 時的路徑），則需修改 PATH 環境變數值如下：
$ export PATH=/opt/phpfarm/inst/bin:$PATH
需要注意的是，此設定方式適用於 bash 及其相容的環境中。
使用範例
01. 於 Apache 中執行不同的 PHP 版本
本篇將介紹在 Apache 中以 FastCGI 的方式整合多個 PHP 版本。
I. 安裝 FastCGI
請於命令列模式下輸入下列指令：
$ sudo apt-get install apache2.2-bin apache2.2-common apache2-mpm-worker libapache2-mod-fcgid libxml2-dev
安裝好之後，我們透過 a2enmod 指令啟動 fastcgi：
$ sudo a2enmod fastcgi
$ sudo a2enmod actions
II. 設定 FastCGI
接著，新增或修改 "/etc/apache2/conf.d/php-cgisetup.conf" 的檔案，內容如下：
FastCgiServer /var/www/cgi-bin/php-cgi-5.3.0
FastCgiServer /var/www/cgi-bin/php-cgi-5.3.1
FastCgiServer /var/www/cgi-bin/php-cgi-5.3.2
ScriptAlias /cgi-bin-php/ /var/www/cgi-bin/
III. 設定 PHP-CGI
上述步驟建立了 3 個不同的 PHP CGI 版本。請依序將此 3 個檔案輸入相關的 PHP-CGI 設定。
先改變檔案屬性為可執行，並且分別將以下程式碼填入，以 php-cgi-5.3.2 為例： ， #!/bin/sh PHPRC="/etc/php5/cgi/5.3.2/" export PHPRC
PHP_FCGI_CHILDREN=3
export PHP_FCGI_CHILDREN
PHP_FCGI_MAX_REQUESTS=5000
expoty PHP_FCGI_MAX_REQUESTS
exec /opt/phpfarm/inst/bin/php-cgi-5.3.2
其它的檔案可仿照上述內容。記得將檔案屬性設定為可執行，並修正版本編號。
需要特別注意 PHPRC 設定，請務必依照此設定建立一個空目錄。在本範例中，需建立 "/etc/php5/cgi/5.3.2" 的空目錄。
IV. 在 VirtualHost 設定單一 PHP 版本
完成前述動作之後，最後一個步驟就是設定 VirtualHost。
Ubuntu 的 Virtual Host 放置於 "/etc/apache2/sites-available" 目錄。可以在該目錄下，建立 phpfarm 的 Virtual Host，內容如下：
AddHandler php-cgi .php
Action php-cgi /cgi-bin-php/php-cgi-5.3.2
Options Indexes FollowSymLinks MultiViews ExecCGI
AllowOverride all
Order allow,deny
allow from all
SetHandler php-cgi
接著執行：
$ sudo a2ensite phpfarm
未來若要測試 PHP 5.3.2 版本時，只需確認環境是運行在 Apache phpfarm 這個 Virtual Host 下即可。執行後可用 phpinfo() 來觀看 PHP 版本資訊。
若要測試其它 PHP 版本，僅需修改 phpfarm 的 Virtual Host 設定，修正 "Action php-cgi" 這一行即可。
02. 在 phpfarm 上安裝 PHP extensions
本範例將介紹安裝 Pecl-APC 模組於 phpfarm 管理的版本中。
I. 安裝 php-pear
首先，請於命令列模式下輸入下列指令，以安裝 php-pear：
$ sudo apt-get install php-pear
使用 pear 搜尋套件之前，請先手動更新 pear channel：
$ sudo pear channel-update doc.php.net
$ sudo pear channel-update pear.php.net
$ sudo pear search -a apc
pear 會依序於 channel 中搜尋 apc 套件。顯示如下：
Retrieving data...0%
no packages found that match pattern "apc", for channel doc.php.net.
Retrieving data...0%
no packages found that match pattern "apc", for channel pear.php.net.
Retrieving data...0%
.Matched packages, channel pecl.php.net:
=======================================
Package Stable/(Latest) Local
APC 3.1.9 (stable) Alternative PHP Cache
接著，使用下列指令下載 Pecl-APC 原始檔：
$ sudo pear download pecl/APC
downloading APC-3.1.9.tgz ...
Starting to download APC-3.1.9.tgz (155,540 bytes)
.................................done: 155,540 bytes
FileAPC-3.1.9.tgz downloaded
$ sudo tar -zxvf APC-3.1.9.tgz
II. 安裝 Pecl-APC
手動安裝 PHP extension 之前，先來介紹 phpize 指令是做什麼用的。phpize 屬於 php-devel，主要用在設定 php 外掛模組，所以安裝 php-devel 相關套件後就可使用 phpize（執行檔預設存放於 /usr/bin/phpize）。如果透過 phpfarm 安裝 PHP 環境，phpize 會被安裝到 /opt/phpfarm/inst/bin/phpize-$version。此外，要執行 phpize 之前，必須先安裝 autoconf 套件才能順利執行。
安裝 autoconf 前，請於命令列模式下輸入下列指令：
$ sudo aptitude install autoconf
接著安裝 APC extension：
$ cd APC-3.1.9
$ /opt/phpfarm/inst/bin/phpize-5.3.2
Configuring for:
PHP Api Version: 20090626
Zend Module Api No: 20090626
Zend Extension Api No: 220090626
$ sudo ./configure --with-php-config=/opt/phpfarm/inst/bin/php-config-5.3.2
$ make && make install
......
Installing shared extensions: /opt/phpfarm/inst/php-5.3.2/lib/php/extensions/debug-non-zts-20090626/
Installing header files: /opt/phpfarm/inst/php-5.3.2/include/php/
安裝完畢之後，就會產生 apc.so，如果要啟動此 extension，請務必在 php.ini 加入以下設定：
extension_dir=/opt/phpfarm/inst/php-5.3.2/lib/php/extensions/debug-non-zts-20090626
extension=apc.so
透過以下指令可以知道 php.ini 檔案的位置：
$ /opt/phpfarm/inst/bin/php-5.3.2 --ini
Configuration File (php.ini) Path: /opt/phpfarm/inst/php-5.3.2/lib
Loaded Configuration File: /opt/phpfarm/inst/php-5.3.2/lib/php.ini
結論
對於在寫大型 Open source project 的開發者來說，有 phpfarm 這類軟體測試不同環境下軟體的狀況，真的是一大福音。畢竟開發出來好用的軟體應該相容於各 PHP 版本，並能解決相依性問題，而在單一台電腦安裝多重版本可以省下很多測試時間。
自由軟體鑄造場電子報 : 第 185 期 程式語言版本管理系統
標籤: php, phpfarm, version manager, environment manager, multiple version, installation management,
分類: 技術專欄
專欄總覽
E-Mail：[email protected] Address：台北市南港區研究院路2段128號 中央研究院資訊科學研究所 . 隱私權條款. 使用條款
評論