oci_error()函式—用法及示例

函式名：oci_error()

適用版本：PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8

函式說明：oci_error() 函式用於獲取最近一次 Oracle 函式或語句執行的錯誤資訊。

語法：oci_error ( resource $resource = ? ) : array|false

引數：

• resource：可選引數，Oracle 的連線資源（由 oci_connect() 或 oci_pconnect() 函式返回）。

返回值：

• 當成功時，返回一個包含錯誤資訊的關聯陣列，其中包括錯誤程式碼（code）、錯誤資訊（message）、錯誤位置（offset）和錯誤語句（sqltext）等欄位。
• 當沒有錯誤時，返回 false。

示例：

<?php
$conn = oci_connect("username", "password", "localhost/XE");

if (!$conn) {
    $error = oci_error();
    echo "連線Oracle資料庫失敗：" . $error['message'];
    exit;
}

$stid = oci_parse($conn, "SELECT * FROM employees");
if (!$stid) {
    $error = oci_error($conn);
    echo "解析SQL語句失敗：" . $error['message'];
    exit;
}

$result = oci_execute($stid);
if (!$result) {
    $error = oci_error($stid);
    echo "執行SQL語句失敗：" . $error['message'];
    exit;
}

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

以上示例展示瞭如何使用 oci_error() 函式來獲取 Oracle 資料庫連線、SQL語句解析和執行過程中的錯誤資訊。如果發生錯誤，將會輸出錯誤資訊到頁面上。注意在實際使用中，應該根據具體情況進行錯誤處理，例如記錄日誌或返回錯誤給使用者。