AppServ 更新 PHP 版本為 5.2.14

AppServ 安裝路徑：D:\AppServ
OS：Windows XP

將 AppServ 2.5.10 的 PHP 5.2.6 升級為 PHP 5.2.14 步驟：

0. 將 Apache 和 MySQL stop。

1. 至 PHP for Windows 下載 VC6 x86 Thread Safe *1 的 zip 版本。

2. 將 D:\AppServ\php5改名為 php526。

3. 將 php-5.2.14-Win32-VC6-x86.zip 解壓縮到 D:\AppServ\php5。

4. 將 php.ini-dist 改為 php.ini。

5. 對照 PHP5.2.6設定的 php.ini 項目來設定 PHP 5.2.14 的 php.ini *2。

6. 將設定好的 php.ini 移到 C:\WINDOWS 內。

7. 如果有開啟 extension=php_mcrypt.dll，記得把 PHP 5.2.14 的 libmcrypt.dll (位於 D:\AppServ\php5內) 重新複製到 C:\WINDOWS 內。

8. start Apache server。

9. 連到 http://localhost/phpinfo.php，版本若為 PHP Version 5.2.14 表示更新成功囉。

p.s. AppServ 自 2008.06.10 release 2.5.10 之後，似乎就沒有更新的版本推出了。所以也可以考慮換個 WAMP 來用，例如 WampServer 或是 XAMPP 來安裝。

*1 AppServ default 是使用 PHP ISAPI 模式執行，所以是建議下載 Thread Safe 的版本。
如果是用 FastCGI模式，則建議使用 Non Thread Safe 的版本。
另外，PHP 5.3 後：
VC6 --> 以Visual Studio 6 編譯 for Apache。
VC9 --> 以Visual Studio 2008 編譯 for IIS。
PHP for Windows 內有詳細說明。

*2 這裡推薦一套好用的文件比對軟體 WinMerge。

AppServ PHP 和 Oracle 10g R2 的 connection 環境建置和設定

環境資料：
OS: Windows
PHP 環境 -- AppServ 2.5.10：

• Apache 2.2.8
• PHP 5.2.6
• MySQL 5.0.51b
• phpMyAdmin-2.10.3
• php OCI8
  
• PHP的安裝目錄設為：D:\AppServ\php5

Oracle DB 10g R2 XE for Windows 或是 Oracle 10g R2 client for Windows

步驟：

1. 請參考 PHP：AppServ 安裝及設定 in Windows 安裝 AppServ 2.5.10。

2. 安裝 Oracle Database 10g R2 XE 或是 Oracle 10g R2 Client，可至 Oracle 網站 下載軟體及查看安裝方式。

安裝完成後，設定或是確定 系統環境變數 PATH 內，有 Oracle library directory 的資料，例如
Oracle client：確定 PATH 內有 D:\oracle\product\10.2.0\client_1\bin。
Oracle DB：確定 PATH 內有 %ORACLE_HOME%\bin 。

如果是安裝 Oracle client，請建立一 tnsnames.ora 文件，放置於 D:\AppServ\oracle\admin\ 內，或是其他任何地方。tnsnames.ora sample。

注意事項：
依據 PHP: OCI8 - Manual 文獻，在 Windows 上使用 OCI8，需要安裝 Oracle 10g R2 以上版本的 client libraries。

3. 安裝 OCI8 in Windows：
AppServ 已有將 OCI8 需要的 php_oci8.dll 安裝於 D:\AppServ\php5\ext 中，所以只要修改 php.ini，將 ;extension=php_oci8.dll uncomment ，並確定 extension_dir 是設到 D:\AppServ\php5\ext 即可。

4. 設定 Oracle 的Windows系統環境變數：

A. ORACLE_HOME：
如果有安裝 Oracel DB，請設定此一環境變數。
ext: ORACLE_HOME=D:\oraclexe\app\oracle\product\10.2.0\server。
如果是安裝 Oracle client，此環境變數可以不用設定。

B. NLS_LANG：
設定 NLS_LANG=AMERICAN_AMERICA.UTF8。
如果是使用 Big5，則設定成 NLS_LANG=AMERICAN_AMERICA.ZHT16BIG5。

C. TNS_ADMIN：
如果是安裝 Oracle client，請設定到 tnsnames.ora 存放的路徑，
ext: TNS_ADMIN=D:\AppServ\oracle\admin。
如果是安裝 Oracle DB 則可以不用設定，因為系統會自動預設為 %ORACLE_HOME%\NETWORK\ADMIN。

注意事項：
依據 PHP: OCI8 - Manual 文獻，說明要在 Web Server 啟動前(例如 Apache 啟動前)，設定好 Oracle 的環境變數。且不要使用 PHP 的 putenv() 來設定。
不過，經過測試，NLS_LANG、TNS_ADMIN、NLS_SORT 是可以使用 putenv() 來設定，使用到目前為止，還沒有出現問題。

5. 測試：(假設 Ap 和 Oracle DB 裝在同一台機器上。)

在 tnsnames.ora 文件內加上下方的資料：

TEST=
(DESCRIPTION =
(ADDRESS_LIST =
(ADDRESS = (PROTOCOL = TCP)(HOST = LOCALHOST)(PORT = 1521))
)
(CONNECT_DATA =
(SID = XE)
)
)

建立測試 php：testOCIConn.php

//oci_connect(string $username, string $password, string $connection_string)
$conn = oci_connect("testconn", "connconn", "TEST");

if(!$conn) {
$e = oci_error();
trigger_error(htmlentities($e['message'], ENT_QUOTES), E_USER_ERROR);
}
else {
echo "testconn 連線成功！！";
}

run testOCIConn.php，如果出現 testconn 連線成功！！，就表示安裝設定成功，且連線成功了。

參考文件：PHP: OCI8 - Manual。

Windows + AppServ PHP 之 php_mcrypt.dll 問題!!

OS : Windows XP
PHP 環境 -- AppServ 2.5.10：

• Apache 2.2.8
• PHP 5.2.6
• MySQL 5.0.51b
• phpMyAdmin-2.10.3
• PHP的安裝目錄設為：D:\AppServ\php5

於 php.ini 裡， 將 ;extension=php_mcrypt.dll uncomment，並重新啟動 apache 後，發現 load mcrypt 出現問題，且該模組也沒有成功的 load。

後來發現原因為 PHP Server 找不到 php_mcrypt.dll 相依的 libmcrypt.dll檔案，即使 path 內有設定相關路徑，也是有錯誤。

解決方法：
將 D:\AppServ\php5 裡的 libmcrypt.dll copy 到 C:\WINDOWS\ 下，然後重新啟動 apache，即可成功載入模組。

PHP：AppServ 安裝及設定 in Windows

1. 安裝 AppServ：

至 AppServ Network 下載 AppServ 2.5.10 :

• Apache 2.2.8
• PHP 5.2.6
• MySQL 5.0.51b
• phpMyAdmin-2.10.3

安裝方式請參閱：How to install AppServ
安裝目錄設為：D:\AppServ

2. 初步設定 PHP.ini：

修改 C:\WINDOWS\php.ini。

• memory_limit = 64M --> 設定 PHP 程式最多允許多少記憶體，改設定為 64 MB。
• max_execution_time = 30 --> 設定 PHP 程式允許執行的時間，單位為秒，改設定為30秒。
• 將 extension=php_mbstring.dll 移到 extension=php_exif.dll 之前，避免安裝 PEAR 時，出現 dll 的錯誤。
• 將 extension_dir = "D:/AppServ\php5\ext" 改為 extension_dir = "D:\AppServ\php5\ext"，修改AppServ 2.5.10的小問題。
• include_path 暫時先不設定，等安裝完 PEAR 後，會自動被設定。
  

重啟 apache。

3. 測試 Apache 和 PHP 是否安裝成功：

a. Apache Server測試 :

• 在 browser 輸入 http://localhost/ ，出現標題為 The AppServ Open Project - 2.5.10 for Windows 的網頁，就表示 Apache 成功啟動了。

b. PHP 測試 :

• 在 browser 輸入 http://localhost/phpinfo.php，出現標題為 PHP Version 5.2.6 的網頁畫面，就表示 php 安裝成功可以使用了。

p.s. phpinfo.php 是 AppServ 安裝後會在 Apache 網站預設根目錄 D:\AppServ\www\ 內放置 的php information 網頁，程式內容為呼叫 phpinfo() function，功能主要是顯示 php 的相關資訊，及安裝的模組。

4. 安裝 PEAR (PHP Extension and Application Repository)

• 執行 D:\AppServ\php5\go-pear.bat 來安裝 PEAR。
• 安裝過程中的詢問選項，都按 Enter 鍵接受預設值。
• 安裝完成後，go-pear.bat 會在 php.ini 最下方加入 include_path=".;D:\AppServ\php5\pear" 的 include path 設定。
  
• 雙按 D:\AppServ\php5\PEAR_ENV.reg 登錄檔來加入環境變數。
• 測試 pear : 開啟 windows 的 cmd 視窗，然後輸入命令 pear version，如果出現 pear 版本訊息，就表示 pear 安裝成功了。
• 重啟 apache server。