為Linux 和Windows 安裝 PHP 和Oracle 10g Instant Client

1、為 Linux 和 Windows 安裝 PHP 和 Oracle 10g Instant Client 作者：Christopher Jones，甲骨文公司的咨詢技術(shù)人員發(fā)布日期：2004 年 12 月 Oracle 10g Instant Client（免費下載）是PHP 與遠程 Oracle 數(shù)據(jù)庫連接的最簡單方式，它只需要安裝三個庫。 PHP 訪問 Oracle 的當前 API 所使用的 Instant Client 庫稱作 OCI8.（此 C 接口的名稱最早是在 Oracle8 中引入的。）PHP Oracle 8 函數(shù) 可以直接調(diào)用 Oracle 8.1.7、9.x 或 10.x，

2、或者也可以為了方便起見，使用可選的抽象類，如 PEAR MDB2 和 ADOdb。 Instant Client 也可以使用老版本的 PHP“oracle”擴展，但它調(diào)用不贊成使用的 Oracle API。PHP 界或 Oracle 建議不要使用此擴展進行新的開發(fā)。 要在 Apache 上將 Instant Client 與 PHP 4 或 連用，請遵循以下步驟。需要一個現(xiàn)有的 Oracle 數(shù)據(jù)庫；Instant Client 不提供 Oracle 數(shù)據(jù)庫。通常情況下，此數(shù)據(jù)庫將位于其他計算機上。如果數(shù)據(jù)庫位于本地，則 Oracle 組件一般早已可用，從而不需要 Instant Client

3、。軟件需求： 軟件附注Oracle Instant Client下載“Instant Client Package - Basic”。在 Linux 上，還應下載“Instant Client Package - SDK”。Apache HTTPD ServerPHP 界仍推薦 Apache 1.3PHP PHP 超文本處理器4.3 版或更高版本在 Windows 上啟用 PHP OCI8 擴展 Instant Client 二進制文件是 PHP 的 Windows 預構(gòu)建二進制文件的補充。 1. 下載 PHP 二進制壓縮文件（不是安裝程序版本）和 Apache。按照 PHP 手冊中的 Win

4、dows 系統(tǒng)上的安裝安裝它們。OTN 的開放源代碼開發(fā)人員中心包含有用背景資料的鏈接，如“在 Windows 2000/XP 上安裝 Oracle、PHP 和 Apache”，它介紹了如何安裝傳統(tǒng)、完整的 Oracle 10g 版本（Instant Client 不需要此版本）。 繼續(xù)操作之前檢查 PHP 是否正常運行。此階段未啟用 Oracle 支持。 2. 從 OTN 的 Instant Client 頁面下載用于 Windows 的 Instant Client Basic 程序包。此壓縮文件的大小大約為 30MB。 3. 創(chuàng)建一個子目錄（例如，c:instantclient10_1）

5、，然后從壓縮文件中復制以下庫： o oraociei10.dll o orannzsbb10.dll o oci.dll 這三個文件的總大小大約為 80MB。 要使用 PHP 老版本的“oracle”擴展（在 php.ini 中使用“extension=php_oracle.dll”啟用），則復制 ociw32.dll 而非 oci.dll。 4. 編輯此環(huán)境，將 c:instantclient10_1 添加到 PATH 中（位于其他 Oracle 目錄之前）。 例如，在 Windows 2000 上，依次單擊“開始”->“設置”->“控制面板”->“系統(tǒng)”->“高級”

6、->“環(huán)境變量”，編輯系統(tǒng)變量列表中的 PATH。 如果使用了 tnsnames.ora 文件定義 Oracle Net 服務名稱，則將 tnsnames.ora 復制到 c:instantclient10_1，并將用戶環(huán)境變量 TNS_ADMIN 設置為 c:instantclient10_1。也可以在用戶環(huán)境變量 LOCAL 中定義默認的服務名稱。 設置必要的 Oracle 全球化語言環(huán)境變量，如 NLS_LANG。如果沒有設置，則使用默認的本地環(huán)境。有關(guān)更多詳細信息，請參見 Oracle PHP 應用程序全球化概述。 無需設置不必要的 Oracle 變量，如 ORACLE_HOME

7、 和 ORACLE_SID。 5. 編輯 php.ini，并不要將 OCI8 擴展設為注釋： 6. extension=php_oci8.dll將 extension_dir 指令設置為完整的 PHP 擴展 DLL 路徑。在 PHP 4 中，DLL 位于 PHP 軟件的“extensions”子目錄中。在 PHP 5 中，它們位于“ext”中。 7. 重新啟動 Apache。 要檢查是否配置了擴展，請在 web 服務器可以讀取的地方創(chuàng)建一個簡單的 PHP 腳本。 <?php phpinfo();?>使用“http:/”URL 將此腳本加載到瀏覽器中。瀏覽器頁面應包含一個顯示“OCI

8、8 Support enabled”的“oci8”部分。 在 Linux 上啟用 PHP OCI8 擴展 要在 Linux 上添加 Oracle 連接，需要重新編譯 PHP。 開放源代碼開發(fā)人員中心包含有用背景資料的鏈接，如在 Linux 上安裝 Oracle、PHP 和 Apache，它介紹了如何安裝傳統(tǒng)、完整的 Oracle 10g 版本（Instant Client 不需要此版本）。 1. 下載并安裝 Apache。例如，在您的主目錄中安裝它： 2. cd apache_1.3.313. ./configure -enable-module=so -prefix=$HOME/apache

9、 -with-port=88884. make5. make install編輯 $HOME/apache/conf/httpd.conf 并添加： AddType application/x-httpd-php .phpAddType application/x-httpd-php-source .phps6. 下載并解壓縮 PHP。7. 從 OTN 上的 Instant Client 頁面下載 Basic 和 SDK Instant Client 程序包。這兩個 RPM 的總大小大約為 30MB。 8. 以 root 用戶的身份安裝 RPM。9. rpm -Uvh oracle-insta

10、ntclient-basic--1.i386.rpm10. rpm -Uvh oracle-instantclient-devel--1.i386.rpm第一個 RPM 將 Oracle 庫置于 /usr/lib/oracle//client/lib 中，第二個 RPM 在 /usr/include/oracle//client 中創(chuàng)建頭 (header)。11. 備份此補丁，然后將它應用于 PHP 的 ext/oci8/config.m4。該補丁的行號是基于 PHP 4.3.9 的。如果已修復了 PHP 錯誤 31084（很有可

11、能已在 PHP 4.3.11 和 5.0.4 中修復），則不需要此補丁。 如果使用的是 PHP 4.3.9 或 4.3.10，則可以將此補丁保存到一個文件中（如 php_oci8ic_buildpatch），然后使用以下命令安裝它：patch -u config.m4 php_oci8ic_buildpatch此補丁創(chuàng)建一個新的 PHP 配置參數(shù)：-with-oci8-instant-client=DIR.在 Linux 上，默認情況下，它使用從 RPM 中安裝的最新版本的 Instant Client。可以指定 Oracle 庫所在的目錄來使用其他版本。無論在哪種情況下，都將自動使用正確的

12、SDK 頭。 新參數(shù)與現(xiàn)有的 -with-oci8 參數(shù)互斥。 例如：在非 Linux 平臺上，將 Instant Client 程序包解壓縮到您所選擇的目錄中。-with-oci8-instant-client 參數(shù)將需要明確指定此目錄；例如，-with-oci8-instant-client=/home/instantclient10_1。應將 Instant Client SDK 解壓縮到與基本程序包相同的目錄中，以便修改后的配置腳本可以找到頭文件的子目錄。 12. 在頂層 PHP 目錄中重新構(gòu)建“configure”腳本。 13. cd php-4.3.914. rm -rf auto

13、m4te.cache config.cache15. ./buildconf -force16. 使用新選項運行 configure。此示例使用安裝在主目錄中的 Apache。 17. ./configure 18. -with-oci8-instant-client 19. -prefix=$HOME/php -with-apxs=$HOME/apache/bin/apxs 20. -enable-sigchild -with-config-file-path=$HOME/apache/conf21. 重建 PHP。22. make23. make install24. 將 PHP 配置復制

14、到 -with-config-file-path 指定的位置25. cp php.ini-recommended $HOME/apache/conf/php.ini26. 將 LD_LIBRARY_PATH 設置為 /usr/lib/oracle//client/lib 并重新啟動 Apache。 如果使用了 tnsnames.ora 文件定義 Oracle Net 服務名稱，則將 TNS_ADMIN 設置為包含此文件的目錄。 啟動 Apache 之前應設置所有 Oracle 環(huán)境變量。以下腳本可以幫助完成此操作： #!/bin/shAPACHEHOME=/home/apach

15、eLD_LIBRARY_PATH=/usr/lib/oracle//client/lib:$LD_LIBRARY_PATHTNS_ADMIN=/homeexport LD_LIBRARY_PATH TNS_ADMINecho Starting Apache $APACHEHOME/apachectl start要確認是否配置了擴展，請在 web 服務器可以讀取的地方創(chuàng)建一個簡單的 PHP 腳本。 <?php phpinfo();?>使用類似“http:/localhost:8888/<path>/phpinfo.php”的 URL 將此腳本加載到瀏覽器中

16、。瀏覽器頁面應包含一個顯示“OCI8 Support enabled”的“oci8”部分。 連接到 Oracle Oracle 連接信息被傳遞給 OCILogon() 來創(chuàng)建連接。與 Instant Client 關(guān)聯(lián)的工具通?！斑h離”任何數(shù)據(jù)庫服務器，因此必須將 Oracle Net 連接標識符與用戶名和口令一起使用。對于已建立的 Oracle 數(shù)據(jù)庫，連接信息有可能是眾所周知的。對于新系統(tǒng)，此信息由 Oracle 安裝程序在安裝數(shù)據(jù)庫時提供。此安裝程序應配置了 Oracle Net 和創(chuàng)建了一個服務名稱。 在新數(shù)據(jù)庫中，可能需要將演示模式（如 HR 用戶）解除鎖定并向其提供口令。也可通過在

17、 SQL*Plus 中以 SYSTEM 用戶身份連接并執(zhí)行以下語句來完成此操作：ALTER USER 用戶名 IDENTIFIED BY 新口令 ACCOUNT UNLOCK;將連接信息傳遞給 PHP 有多種方法。第一個示例使用 Oracle 10g的 Easy Connect 語法連接到 在 mymachine 上運行的 MYDB 數(shù)據(jù)庫服務中的 HR 模式。不需要 tnsnames.ora 或其他 Oracle Network 文件： $c = OCILogon('hr', 'hr_password', '/mymachine.mydomain/MY

18、DB');有關(guān) Easy Connect 的語法，請參見 Oracle 的使用 Easy Connect 命名方法文檔。 或者，如果 /home/tnsnames.ora 包含： MYDB =(DESCRIPTION=(ADDRESS = (PROTOCOL = TCP)(HOST = mymachine.mydomain)(PORT = 1521)(CONNECT_DATA=(SERVER = DEDICATED)(SERVICE_NAME = MYDB) ) )且 TNS_ADMIN 環(huán)境變量設置為 /home（在啟動 Apache 之前），則連接字符串可以為： $c = OCIL

19、ogon('hr', 'hr_password', 'MYDB');如果環(huán)境變量 LOCAL（在 Windows 上）或 TWO_TASK （在 Linux 上）設置為 MYDB，則可以使用以下代碼生成與 MYDB 連接： $c = OCILogon('hr', 'hr_password');使用 Oracle 當基本連接可以使用時，試著運行一個簡單的腳本 testoci.php。根據(jù)您的數(shù)據(jù)庫修改該連接的詳細信息并在瀏覽器中加載它。此示例列出了用戶 HR 擁有的所有表： <?php $conn = OCIL

20、ogon("hr", "hr_password", '/mymachine.mydomain:port/MYDB);$query = 'select table_name from user_tables'$stid = OCIParse($conn, $query);OCIExecute($stid, OCI_DEFAULT);while ($succ = OCIFetchInto($stid, $row) foreach ($row as $item) echo $item." " echo "<br>n" OCILogoff($conn); ?>故障診斷 Oracle PHP 故障診斷常見問題解答包含有關(guān)連接 Oracle 的有用信息。 可以從 In