PHP 連接 Oracle 數據庫完整指南：配置、連接與查詢實戰

PHP 連接 Oracle 數據庫完整指南：配置、連接與查詢實戰

PHP 不僅擅長 MySQL，通過 OCI8 擴展也能高效連接 Oracle。本文涵蓋擴展安裝、多種連接字符串寫法、完整查詢示例與常見問題排查，助你快速落地 PHP-Oracle 開發。

環境準備：啟用 OCI8 擴展

1. 編輯 php.ini，取消註釋：extension=php_oci8.dll（Windows）或 extension=oci8.so（Linux）。
2. 重啟 Apache / PHP-FPM。
3. 若報錯「Unable to load dynamic library」，將 php_oci8.dll 複製到系統路徑（如 C:\Windows\System32）或設置 PATH 包含 PHP 目錄。
4. 確保安裝 Oracle Instant Client（Basic + SDK），並配置環境變量 ORACLE_HOME、LD_LIBRARY_PATH / PATH。

三種主流連接字符串寫法

1. 完整 TNS 描述（最通用，無需 tnsnames.ora）

$conn = oci_connect(
    'username', 'password',
    "(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=192.168.1.100)(PORT=1521))
    (CONNECT_DATA=(SID=test)))"
);

2. 簡易 EZConnect 格式（推薦，簡潔）

$conn = oci_connect('username', 'password', '192.168.1.100/test');
// 格式：host/service_name 或 host:port/service_name

3. 使用 tnsnames.ora 別名（需客戶端配置）

$conn = oci_connect('username', 'password', 'ORCL_ALIAS');

完整查詢示例（PHP 5.0+ 推薦寫法）

<?php
$conn = oci_connect('hr', 'hr', 'orcl');
if (!$conn) {
    $e = oci_error();
    die(htmlentities($e['message']));
}

$query = 'SELECT * FROM DEPARTMENTS';
$stid = oci_parse($conn, $query);
if (!$stid) {
    $e = oci_error($conn);
    die(htmlentities($e['message']));
}

$r = oci_execute($stid, OCI_DEFAULT); // 不自動提交
if (!$r) {
    $e = oci_error($stid);
    die(htmlentities($e['message']));
}

// 輸出 HTML 表格
print '<table border="1">';
while ($row = oci_fetch_array($stid, OCI_RETURN_NULLS)) {
    print '<tr>';
    foreach ($row as $item) {
        print '<td>' . ($item !== null ? htmlentities($item) : ' ') . '</td>';
    }
    print '</tr>';
}
print '</table>';

oci_free_statement($stid);
oci_close($conn);
?>

關鍵函數速查表

常見問題與解決

• ORA-12154 / ORA-12541：網絡不通、監聽未啟動、HOST/PORT/SID 錯誤、防火牆攔截。用 `tnsping` 測試。
• ORA-28040：認證協議不匹配，Oracle 12c+ 需設置 SQLNET.ALLOWED_LOGON_VERSION_SERVER=8 或升級客戶端。
• 中文亂碼：設置環境變量 NLS_LANG=SIMPLIFIED CHINESE_CHINA.AL32UTF8（Linux 在啟動腳本中 export，Windows 在註冊表/系統變量）。
• 內存洩漏：循環查詢務必調用 oci_free_statement，長運行腳本定期 oci_close 重連。

進階提示

• 生產環境建議使用 連接池（OCI8 2.0+ 支持 `oci8.connection_class` + DRCP）或持久連接減少握手開銷。
• 大數據量分頁查詢使用 Oracle 12c OFFSET ... FETCH NEXT 或傳統 ROWNUM 子查詢優化。
• 結合 oci_bind_by_name 實現參數化查詢，防 SQL 注入並利用執行計劃緩存。

總結

PHP 連接 Oracle 核心在於：正確安裝 Instant Client + OCI8、選用 EZConnect 簡化配置、善用預編譯與綁定變量、注意 NLS_LANG 編碼設置。掌握以上要點，即可在 PHP 中穩定高效操作 Oracle 數據庫。