萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

CentOS 安裝 PHP Oracle 擴展 (OCI8) 完整步驟:Instant Client、編譯配置、php.ini 載入與驗證

在 CentOS 6 + PHP 5.3 環境為 Laravel/原生 PHP 專案安裝 Oracle OCI8 擴展,需依次安裝 Oracle Instant Client RPM 包、編譯 OCI8 擴展、配置 php.ini。本文提供經驗證的完整命令序列。

環境基線

  • OS:CentOS 6 (x64)
  • PHP:5.3.28(編譯安裝於 /usr/local/php)
  • Oracle Instant Client:10.2.0.4 (x64)

1. 安裝 Oracle Instant Client RPM

# 下載四個核心 RPM(從 Oracle 官網需登錄)
oracle-instantclient-basic-10.2.0.4-1.x86_64.rpm
oracle-instantclient-devel-10.2.0.4-1.x86_64.rpm
oracle-instantclient-jdbc-10.2.0.4-1.x86_64.rpm
oracle-instantclient-sqlplus-10.2.0.4-1.x86_64.rpm

# 批量安裝
rpm -ivh *.rpm

安裝後庫文件位於 /usr/lib/oracle/10.2.0.4/client64/lib/。

2. 下載並編譯 OCI8 擴展

# 獲取源碼(PECL 官方)
wget https://pecl.php.net/get/oci8-2.0.7.tgz
tar zxvf oci8-2.0.7.tgz
cd oci8-2.0.7

# phpize 生成配置腳本
/usr/local/php/bin/phpize

# 配置:指定 php-config 與 Oracle Instant Client 路徑
./configure --with-php-config=/usr/local/php/bin/php-config \
            --with-oci8=shared,instantclient,/usr/lib/oracle/10.2.0.4/client64/lib/

# 編譯安裝
make && make install

輸出提示 Installing shared extensions: /usr/local/php/lib/php/extensions/no-debug-non-zts-20090626/,記錄 .so 路徑。

3. 修改 php.ini 載入擴展

vi /usr/local/php/etc/php.ini
# 末尾添加
extension = "oci8.so"

4. 重啟 PHP-FPM 並驗證

# 查找 master 進程 PID
ps aux | grep php | grep root
# 平滑重啟(發送 USR2 信號)
kill -USR2 

# 或 systemd 管理
systemctl reload php-fpm

# 驗證
php -m | grep oci8
php -r 'echo oci_client_version();'  # 輸出如 10.2.0.4.0 即成功

常見問題排查

錯誤現象原因解決
libclntsh.so: cannot open shared object file動態庫路徑未加入 ldconfigecho /usr/lib/oracle/10.2.0.4/client64/lib > /etc/ld.so.conf.d/oracle.conf && ldconfig
OCIEnvNlsCreate failed字符集/環境變量缺失設置 export NLS_LANG=AMERICAN_AMERICA.AL32UTF8 於啟動腳本
phpize: command not found未安裝 php-develyum install php-devel 或使用編譯版 PHP 的 phpize
版本不匹配OCI8 版本與 PHP API 版本不符選擇對應 PHP 版本的 OCI8 包(如 PHP 5.3 用 oci8-2.0.x)

現代化建議

  • 新專案使用 **Oracle 19c/21c Instant Client + PHP 7.4+/8.x + PECL oci8-3.x**。
  • Docker 部署:FROM php:8.2-fpm + RUN pecl install oci8 + 複製 Instant Client 基礎鏡像。
  • 使用 PDO_OCI 驅動(PDO 介面統一),而非直接調用 oci_* 函數。

OCI8 安裝的核心難點在於 **Instant Client 版本、PHP API 版本、編譯工具鏈三方對齊**;按本文版本組合操作,可在 CentOS 6/7 歷史環境穩定落地。

copyright © 萬盛學電腦網 all rights reserved