萬盛學電腦網

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

PHP 呼叫 Oracle 預存程序完整實作指南

在企業級應用中,將商業邏輯封裝於 Oracle 預存程序,再由 PHP 呼叫,可大幅提升效能(減少網路來回)、強化安全性(權限控管)與維護性。本文完整示範從資料庫建立到 PHP OCI8 操作的全流程。

資料庫端:建立測試表與預存程序

-- 建立測試表
CREATE TABLE TEST (
    ID   NUMBER(16) NOT NULL PRIMARY KEY,
    NAME VARCHAR2(30) NOT NULL
);

INSERT INTO TEST VALUES (5, 'PHP_BOOK');
COMMIT;

-- 建立預存程序:依 ID 查詢 NAME
CREATE OR REPLACE PROCEDURE PROC_TEST (
    p_id  IN OUT NUMBER,
    p_name OUT VARCHAR2
) AS
BEGIN
    SELECT NAME INTO p_name
    FROM TEST
    WHERE ID = p_id;
END PROC_TEST;
/

PHP 端:OCI8 呼叫流程

<?php
// 連線參數
$user = 'scott';
$pass = 'tiger';
$tns  = 'ORCL'; // tnsnames.ora 別名
$remote = true;

if ($remote) {
    $conn = OCILogon($user, $pass, $tns);
} else {
    $conn = OCILogon($user, $pass); // 本地連線
}

if (!$conn) {
    $e = OCIError();
    die('Connection failed: ' . $e['message']);
}

// 綁定變數
$id   = 5;
$name = ' '; // 預留空間,長度對應 VARCHAR2(30)

// 預存程序呼叫語法:BEGIN 程序名(:參數1, :參數2); END;
$sql = 'BEGIN PROC_TEST(:id, :name); END;';

$stmt = OCIParse($conn, $sql);
if (!$stmt) {
    $e = OCIError($conn);
    die('Parse failed: ' . $e['message']);
}

// 綁定 PHP 變數至 Oracle 佔位符
// OCIBindByName($stmt, $ph_name, &$php_var, $maxlen)
OCIBindByName($stmt, ':id',   $id,   16); // NUMBER(16)
OCIBindByName($stmt, ':name', $name, 30); // VARCHAR2(30)

// 執行
if (!OCIExecute($stmt)) {
    $e = OCIError($stmt);
    die('Execute failed: ' . $e['message']);
}

// 結果已寫回 $name 變數
echo 'Name is: ' . $name . '<br>';

// 釋放資源
OCIFreeStatement($stmt);
OCILogoff($conn);
?>

關鍵技術細節

1. 參數模式與綁定

Oracle 模式PHP 綁定方式說明
INOCIBindByName($stmt, ':p', $var, $len)單向輸入,PHP 變數值傳給 PL/SQL
OUTOCIBindByName($stmt, ':p', $var, $len)單向輸出,PL/SQL 寫回 PHP 變數,需預留長度
IN OUT同上雙向,呼叫前有值,呼叫後被覆寫

2. 錯誤處理最佳實務

function oci_check($resource, $context = '') {
    $e = OCIError($resource);
    if ($e) {
        error_log("OCI Error [$context]: {$e['message']} (Code: {$e['code']})");
        throw new Exception("Database error: {$e['message']}");
    }
}

// 使用範例
$stmt = OCIParse($conn, $sql);
oci_check($conn, 'Parse');
OCIBindByName($stmt, ':id', $id, 16);
oci_check($stmt, 'Bind ID');
OCIExecute($stmt);
oci_check($stmt, 'Execute');

3. 游標回傳 (REF CURSOR)

若預存程序回傳結果集,需綁定游標:

$cursor = OCINewCursor($conn);
OCIBindByName($stmt, ':cursor', $cursor, -1, OCI_B_CURSOR);
OCIExecute($stmt);
OCIExecute($cursor); // 額外執行游標
while (OCIFetchInto($cursor, $row, OCI_ASSOC)) {
    print_r($row);
}

效能與架構建議

  • 連線池:生產環境使用 OCIPLogon (Persistent) 或 OCI8 連線池 (oci8.connection_class)
  • 批次處理:大量資料操作改用 OCIBindArrayByName + OCIExecute($stmt, OCI_BATCH_MODE)
  • SQL 注入防護:綁定變數天然防注入,嚴禁字串拼接 SQL
  • 編碼一致性:確保 PHP NLS_LANG、資料庫 NLS_CHARACTERSET、網頁 charset 三者一致(建議全 UTF-8)
copyright © 萬盛學電腦網 all rights reserved