OCILob::save()函式—用法及示例

函式名稱：OCILob::save()

函式描述：該函式用於儲存LOB（Large Object）資料到檔案或者其他LOB物件。

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

語法：bool OCILob::save(string $filename [, int $offset = 0 [, int $length = 0 ]])

引數：

• $filename: 儲存LOB資料的目標檔名或者其他LOB物件。
• $offset（可選）: 從LOB資料的指定偏移量開始儲存。預設為0，表示從LOB的開頭開始。
• $length（可選）: 儲存的資料長度。預設為0，表示儲存全部LOB資料。

返回值：成功時返回true，失敗時返回false。

示例：

<?php
// 建立一個連線
$conn = oci_connect("username", "password", "localhost/XE");

if (!$conn) {
    $e = oci_error();
    trigger_error(htmlentities($e['message'], ENT_QUOTES), E_USER_ERROR);
}

// 準備一個查詢語句
$query = "SELECT lob_column FROM my_table WHERE id = :id";

// 準備一個語句控制代碼
$stmt = oci_parse($conn, $query);

// 繫結引數
$id = 1;
oci_bind_by_name($stmt, ":id", $id);

// 執行查詢
if (!oci_execute($stmt)) {
    $e = oci_error($stmt);
    trigger_error(htmlentities($e['message'], ENT_QUOTES), E_USER_ERROR);
}

// 獲取LOB資料
if (oci_fetch($stmt)) {
    $lob = oci_result($stmt, 'LOB_COLUMN');

    // 將LOB資料儲存到檔案
    $filename = 'lob_data.txt';
    if (OCILob::save($lob, $filename)) {
        echo "LOB資料儲存成功!";
    } else {
        echo "LOB資料儲存失敗!";
    }
}

// 關閉連線
oci_close($conn);
?>

上述示例程式碼展示瞭如何使用OCILob::save()函式將從資料庫中獲取的LOB資料儲存到檔案。首先，我們建立一個資料庫連線，然後準備一個查詢語句，並繫結引數。接著，執行查詢，並使用oci_fetch()函式獲取LOB資料。最後，我們將獲取到的LOB資料儲存到指定的檔案中，透過呼叫OCILob::save()函式，並根據返回值判斷儲存是否成功。