安裝 PHP 和 Oracle 10g 即時客戶端

2024-08-29 13:35:50

字體：大中小

供稿：網(wǎng)友

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，或者也可以為了方便起見，使用可選的抽象類，如 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。
軟件需求：軟件附注 Oracle Instant Client 下載“Instant Client Package - Basic”。
在 linux 上，還應下載“Instant Client Package - SDK”。 Apache HTTPD Server PHP 界仍推薦 Apache 1.3 PHP — PHP 超文本處理器 4.3 版或更高版本
在 Windows 上啟用 PHP OCI8 擴展 Instant Client 二進制文件是 PHP 的 Windows 預構(gòu)建二進制文件的補充。

下載 PHP 二進制壓縮文件（不是安裝程序版本）和 Apache。按照 PHP 手冊中的 Windows 系統(tǒng)上的安裝安裝它們。OTN 的開放源代碼開發(fā)人員中心包含有用背景資料的鏈接，如“在 windows 2000/XP 上安裝 Oracle、PHP 和 Apache”，它介紹了如何安裝傳統(tǒng)、完整的 Oracle 10g 版本（Instant Client 不需要此版本）。繼續(xù)操作之前檢查 PHP 是否正常運行。此階段未啟用 Oracle 支持。
從 OTN 的 Instant Client 頁面下載用于 Windows 的 Instant Client Basic 程序包。此壓縮文件的大小大約為 30MB。
創(chuàng)建一個子目錄（例如，c:/instantclient10_1），然后從壓縮文件中復制以下庫：
- oraociei10.dll
- orannzsbb10.dll
- oci.dll
這三個文件的總大小大約為 80MB。要使用 PHP 老版本的“oracle”擴展（在 php.ini 中使用“extension=php_oracle.dll”啟用），則復制 ociw32.dll 而非 oci.dll。
編輯此環(huán)境，將 c:/instantclient10_1 添加到 PATH 中（位于其他 Oracle 目錄之前）。例如，在 Windows 2000 上，依次單擊“開始”->“設置”->“控制面板”->“系統(tǒng)”->“高級”->“環(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)境。有關更多具體信息，請參見 Oracle PHP 應用程序全球化概述。
無需設置不必要的 Oracle 變量，如 ORACLE_HOME 和 ORACLE_SID。
編輯 php.ini，并不要將 OCI8 擴展設為注釋： extension=php_oci8.dll將 extension_dir 指令設置為完整的 PHP 擴展 DLL 路徑。在 PHP 4 中，DLL 位于 PHP 軟件的“extensions”子目錄中。在 PHP 5 中，它們位于“ext”中。
重新啟動 Apache。

要檢查是否配置了擴展，請在 web 服務器可以讀取的地方創(chuàng)建一個簡單的 PHP 腳本。 <?php phpinfo();?>使用“http://”URL 將此腳本加載到瀏覽器中。瀏覽器頁面應包含一個顯示“OCI8 Support enabled”的“oci8”部分。在 Linux 上啟用 PHP OCI8 擴展要在 Linux 上添加 Oracle 連接，需要重新編譯 PHP。開放源代碼開發(fā)人員中心包含有用背景資料的鏈接，如在 Linux 上安裝 Oracle、PHP 和 Apache，它介紹了如何安裝傳統(tǒng)、完整的 Oracle 10g 版本（Instant Client 不需要此版本）。

下載并安裝 Apache。例如，在您的主目錄中安裝它： cd apache_1.3.31./configure --enable-module=so --PRefix=$HOME/apache --with-port=8888makemake install編輯 $HOME/apache/conf/httpd.conf 并添加： AddType application/x-httpd-php .phpAddType application/x-httpd-php-source .phps
下載并解壓縮 PHP。
從 OTN 上的 Instant Client 頁面下載 Basic 和 SDK Instant Client 程序包。這兩個 RPM 的總大小大約為 30MB。
以 root 用戶的身份安裝 RPM。rpm -Uvh oracle-instantclient-basic-10.1.0.3-1.i386.rpmrpm -Uvh oracle-instantclient-devel-10.1.0.3-1.i386.rpm第一個 RPM 將 Oracle 庫置于 /usr/lib/oracle/10.1.0.3/client/lib 中，第二個 RPM 在 /usr/include/oracle/10.1.0.3/client 中創(chuàng)建頭 (header)。
備份此補丁，然后將它應用于 PHP 的 ext/oci8/config.m4。該補丁的行號是基于 PHP 4.3.9 的。假如已修復了 PHP 錯誤 31084（很有可能已在 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 庫所在的目錄來使用其他版本。無論在哪種情況下，都將自動使用正確的 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 解壓縮到與基本程序包相同的目錄中，以便修改后的配置腳本可以找到頭文件的子目錄。
在頂層 PHP 目錄中重新構(gòu)建“configure”腳本。 cd php-4.3.9rm -rf autom4te.cache config.cache./buildconf --force
使用新選項運行 configure。此示例使用安裝在主目錄中的 Apache。 ./configure /--with-oci8-instant-client /--prefix=$HOME/php --with-apxs=$HOME/apache/bin/apxs /--enable-sigchild --with-config-file-path=$HOME/apache/conf
重建 PHP。makemake install
將 PHP 配置復制到 --with-config-file-path 指定的位置cp php.ini-recommended $HOME/apache/conf/php.ini
將 LD_LIBRARY_PATH 設置為 /usr/lib/oracle/10.1.0.3/client/lib 并重新啟動 Apache。假如使用了 tnsnames.ora 文件定義 Oracle Net 服務名稱，則將 TNS_ADMIN 設置為包含此文件的目錄。啟動 Apache 之前應設置所有 Oracle 環(huán)境變量。以下腳本可以幫助完成此操作： #!/bin/shAPACHEHOME=/home/apacheLD_LIBRARY_PATH=/usr/lib/oracle/10.1.0.3/client/lib:${LD_LIBRARY_PATH}TNS_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 將此腳本加載到瀏覽器中。瀏覽器頁面應包含一個顯示“OCI8 Support enabled”的“oci8”部分。連接到 Oracle Oracle 連接信息被傳遞給 OCILogon() 來創(chuàng)建連接。與 Instant Client 關聯(lián)的工具通常“遠離”任何數(shù)據(jù)庫服務器，因此必須將 Oracle Net 連接標識符與用戶名和口令一起使用。對于已建立的 Oracle 數(shù)據(jù)庫，連接信息有可能是眾所周知的。對于新系統(tǒng)，此信息由 Oracle 安裝程序在安裝數(shù)據(jù)庫時提供。此安裝程序應配置了 Oracle Net 和創(chuàng)建了一個服務名稱。在新數(shù)據(jù)庫中，可能需要將演示模式（如 HR 用戶）解除鎖定并向其提供口令。也可通過在 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/MYDB');有關 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 = OCILogon('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 = OCILogon("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 故障診斷常見問題解答包含有關連接 Oracle 的有用信息。可以從 Instant Client 頁面下載 Oracle 的 SQL*Plus 命令行工具來幫助解決環(huán)境問題和連接問題。另請參見 SQL*Plus Instant Client 版本說明。檢查 SQL*Plus 使用的環(huán)境是否與 phpinfo.php 顯示的環(huán)境相同。 Windows 幫助假如 phpinfo.php 腳本沒有生成顯示“OCI8 Support enabled”的“oci8”部分，則確認在 php.ini 中沒有將“extension=php_oci8.dll”設為注釋。
假如 PATH 設置錯誤，或找不到 Oracle 庫，則啟動 Apache 將顯示警告：“在指定的路徑中找不到動態(tài)鏈接庫 OCI.dll。”phpinfo() 頁面的 Environment 部分將顯示 PATH 的值以及 PHP 實際使用的 Oracle 變量。假如 php.ini 的 extension_dir 指令不正確，則在啟動 Apache 將顯示警告：“PHP 啟動：無法加載動態(tài)庫 php_oci8.dll。” Linux 幫助仔細檢查是否正確修復了 config.m4。假如“configure”失敗，則檢查 config.log 文件。還原 config.m4，刪除緩存文件，運行 ./buildconf --force and configure，驗證問題是否與所做的更改相關。確保“configure”上的時間戳是當前的。刪除所有緩存文件，并在必要時重建它。在啟動 Apache 的 shell 中設置所有必要的 Oracle 環(huán)境變量。結(jié)論希望本文對您能有所幫助。您可以在 OTN Instant Client 或 PHP 論壇上發(fā)表問題和建議。

上一篇：在MTS使用ODP讀寫Oracle是出現(xiàn)無法加載OraMTS的解決辦法

下一篇：在Windows 2000下優(yōu)化Oracle9i性能