fbird_blob_import()函式—用法及示例

函式名稱：fbird_blob_import()

適用版本：Firebird 2.0 及更高版本

函式描述：fbird_blob_import() 函式用於將二進位制資料匯入到 BLOB 列中。

語法：fbird_blob_import(resource $blob_handle, string $file_name)

引數：

• $blob_handle：表示一個有效的 Firebird BLOB 控制程式碼，可以透過 fbird_blob_create() 或 fbird_blob_open() 函式獲取。
• $file_name：表示要匯入的檔案的完整路徑和檔名。

返回值：成功匯入資料返回 TRUE，失敗返回 FALSE。

示例：

<?php
// 連線到 Firebird 資料庫
$database = ibase_connect('localhost:/path/to/database.fdb', 'username', 'password');

// 建立一個 BLOB 列
$blob_handle = fbird_blob_create($database);

// 開啟要匯入的檔案
$file_name = '/path/to/file.pdf';
$file_handle = fopen($file_name, 'rb');

// 匯入檔案資料到 BLOB 列
if (fbird_blob_import($blob_handle, $file_name)) {
    echo '檔案匯入成功！';
} else {
    echo '檔案匯入失敗！';
}

// 關閉檔案控制程式碼和 BLOB 控制程式碼
fclose($file_handle);
fbird_blob_close($blob_handle);

// 關閉資料庫連線
ibase_close($database);
?>

注意事項：

1. 在使用 fbird_blob_import() 函式之前，需要確保已經連線到 Firebird 資料庫，並且已經建立了一個有效的 BLOB 列。
2. 要匯入的檔案必須存在，並且具有可讀許可權。
3. 匯入的檔案資料將被寫入到 BLOB 列中，如果 BLOB 列中已經存在資料，則新的資料將覆蓋原有資料。
4. 使用 fbird_blob_close() 函式關閉 BLOB 控制程式碼，確保釋放相關資源。
5. 使用 ibase_close() 函式關閉資料庫連線，釋放相關資源。