oci_define_by

說明

bool oci_define_by_name ( resource statement, string column_name, mixed &variable [, int type] )

oci_define_by_name() 綁定 PHP 到取得的 SQL 列。需要注意的是，Oracle 使用大寫字母的列名，而會員在 select 中也可以用小寫字母。oci_define_by_name() 期望 column_name 是大寫字母。若果定義一個變量不存在於 select 語句中，將沒有錯誤被給出。

若果需要定義一個抽像資料類型（LOB/ROWID/BFILE），必須先用 oci_new_descriptor() 配置空間。參見 oci_bind_by_name() 函數。

例子 1. oci_define_by_name() 例子


<?php
/* oci_define_by_name example - thies at thieso dot net (980219) */

$conn = oci_connect("scott", "tiger");

$stmt = oci_parse($conn, "SELECT empno, ename FROM emp");

/* the define MUST be done BEFORE oci_execute! */

oci_define_by_name($stmt, "EMPNO", $empno);
oci_define_by_name($stmt, "ENAME", $ename);

oci_execute($stmt);

while (oci_fetch($stmt)) {
    echo "empno:" . $empno . "\n";
    echo "ename:" . $ename . "\n";
}

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

注: 在 PHP 5.0.0 之前的版本必須使用 ocidefinebyname() 替代本函數。該函數名仍然可用，為向下相容作為 oci_define_by_name() 的別名。不過其已被廢棄，不推薦使用。