PHP5.3連線Oracle的客戶端及PDO_OCI模組安裝

php連線oracle資料庫雖然不是最佳拍檔，但組內開發確實有這樣需求。如果沒有參考合適的文件，這個過程還是挺折磨人的，下面是一個記錄，原型是國外的一篇部落格 Installing PDO_OCI and OCI8 PHP extensions on CentOS 6.4 64bit。

假設你已經安裝好php的環境，php版本為5.3，要連線的oracle伺服器是 11g R2，作業系統版本CentOS 6.4 x86_64。如果沒有安裝php，可以通過以下命令安裝：

# yum install php php-pdo
# yum install php-devel php-pear php-fpm php-gd php-ldap 
php-mbstring php-xml php-xmlrpc  php- zlib zlib-devel bc libaio glibc

假如web伺服器使用apache。

1. 安裝InstantClient

instantclient是oracle的連線資料庫的簡單客戶端，不用安裝一個500Moracle客戶端就可以連線oracle資料庫，有windows和linux版本。從 這裡 選擇需要的版本下載，只需Basic和Devel兩個rpm包。

安裝
# rpm -ivh oracle-instantclient11.2-basic-11.2.0.4.0-1.x86_64.rpm
# rpm -ivh oracle-instantclient11.2-devel-11.2.0.4.0-1.x86_64.rpm

軟連結
# ln -s /usr/include/oracle/11.2/client64 /usr/include/oracle/11.2/client
# ln -s /usr/lib/oracle/11.2/client64 /usr/lib/oracle/11.2/client

64位系統需要建立32位的軟連結，這裡可能是一個遺留bug，不然後面編譯會出問題。

接下來還要讓系統能夠找到oracle客戶端的庫檔案，修改LD_LIBRARY_PATH：

# vi /etc/profile.d/oracle.sh
export ORACLE_HOME=/usr/lib/oracle/11.2/client64
export LD_LIBRARY_PATH=$ORACLE_HOME/lib

執行source /etc/profile.d/oracle.sh使環境變數生效。

2. 安裝PDO_OCI

在連線網際網路的情況下，通過pecl線上安裝php的擴充套件非常簡單，參考 How to install oracle instantclient and pdo_oci on ubuntu machine 。

從https://pecl.php.net/package/PDO_OCI下載 PDO_OCI-1.0.tgz 原始檔。

# wget https://pecl.php.net/get/PDO_OCI-1.0.tgz
# tar -xvf PDO_OCI-1.0.tgz
# cd PDO_OCI-1.0

由於PDO_OCI很久沒有更新，所以下面需要編輯ODI_OCI-1.0資料夾裡的config.m4檔案來讓它支援11g：

# 在第10行左右找到與下面類似的程式碼，新增這兩行：
elif test -f $PDO_OCI_DIR/lib/libclntsh.$SHLIB_SUFFIX_NAME.11.2; then
  PDO_OCI_VERSION=11.2

# 在第101行左右新增這幾行：
11.2)
  PHP_ADD_LIBRARY(clntsh, 1, PDO_OCI_SHARED_LIBADD)
  ;;

編譯安裝pdo_oci擴充套件：（安裝完成後可在 /usr/lib64/php/modules/pdo_oci.so 找到這個模組）

$ phpize
$ ./configure --with-pdo-oci=instantclient,/usr,11.2
$ make
$ sudo make install

要啟用這個擴充套件，在/etc/php.d/下新建一個pdo_oci.ini檔案，內容：

extension=pdo_oci.so

驗證安裝成功：

# php -i|grep oci
看到類似下面的內容則安裝成功:
/etc/php.d/pdo_oci.ini,
PDO drivers => oci, sqlite

或
# php -m

3. 安裝OCI8

從 https://pecl.php.net/package/oci8 下載oci8-2.0.8.tgz原始檔。

# wget https://pecl.php.net/get/oci8-2.0.8.tgz
# tar -xvf oci8-2.0.8.tgz
# cd oci8-2.0.8

編譯安裝oci8擴充套件：

# phpize
# ./configure --with-oci8=shared,instantclient,/usr/lib/oracle/11.2/client64/lib
# make
# make install

要啟用這個擴充套件，在/etc/php.d/下新建一個oci8.ini檔案，內容：

extension=oci8.so

驗證安裝成功：

# php -i|grep oci8
/etc/php.d/oci8.ini,
oci8
oci8.connection_class => no value => no value
oci8.default_prefetch => 100 => 100
oci8.events => Off => Off
oci8.max_persistent => -1 => -1
oci8.old_oci_close_semantics => Off => Off
oci8.persistent_timeout => -1 => -1
oci8.ping_interval => 60 => 60
oci8.privileged_connect => Off => Off
oci8.statement_cache_size => 20 => 20
OLDPWD => /usr/local/src/oci8-2.0.8
_SERVER["OLDPWD"] => /usr/local/src/oci8-2.0.8

最後別忘了重啟逆web伺服器如apache，可以通過phpinfo()來確保擴充套件是否成功安裝。

4. 測試連線

在你web伺服器如apache的php目錄下建立testoci.php：

<?php

$conn = oci_connect(`username`, `password`, `172.29.88.178/DBTEST`);

$stid = oci_parse($conn, `select table_name from user_tables`);
oci_execute($stid);

echo "<table>
";
while (($row = oci_fetch_array($stid, OCI_ASSOC+OCI_RETURN_NULLS)) != false) {
    echo "<tr>
";
    foreach ($row as $item) {
        echo "  <td>".($item !== null ? htmlentities($item, ENT_QUOTES) : "&nbsp;")."</td>
";
    }
    echo "</tr>
";
}
echo "</table>
";

?>

訪問這個頁面就應該可以得到結果了。