在 CentOS 6 + PHP 5.3 環境為 Laravel/原生 PHP 專案安裝 Oracle OCI8 擴展,需依次安裝 Oracle Instant Client RPM 包、編譯 OCI8 擴展、配置 php.ini。本文提供經驗證的完整命令序列。
/usr/local/php)# 下載四個核心 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/。
# 獲取源碼(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 路徑。
vi /usr/local/php/etc/php.ini
# 末尾添加
extension = "oci8.so"
# 查找 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 | 動態庫路徑未加入 ldconfig | echo /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-devel | yum install php-devel 或使用編譯版 PHP 的 phpize |
| 版本不匹配 | OCI8 版本與 PHP API 版本不符 | 選擇對應 PHP 版本的 OCI8 包(如 PHP 5.3 用 oci8-2.0.x) |
FROM php:8.2-fpm + RUN pecl install oci8 + 複製 Instant Client 基礎鏡像。OCI8 安裝的核心難點在於 **Instant Client 版本、PHP API 版本、編譯工具鏈三方對齊**;按本文版本組合操作,可在 CentOS 6/7 歷史環境穩定落地。