在企業級應用中,將商業邏輯封裝於 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
// 連線參數
$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);
?>
| Oracle 模式 | PHP 綁定方式 | 說明 |
|---|---|---|
| IN | OCIBindByName($stmt, ':p', $var, $len) | 單向輸入,PHP 變數值傳給 PL/SQL |
| OUT | OCIBindByName($stmt, ':p', $var, $len) | 單向輸出,PL/SQL 寫回 PHP 變數,需預留長度 |
| IN OUT | 同上 | 雙向,呼叫前有值,呼叫後被覆寫 |
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');
若預存程序回傳結果集,需綁定游標:
$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)NLS_LANG、資料庫 NLS_CHARACTERSET、網頁 charset 三者一致(建議全 UTF-8)