(PHP 5, PHP 7, PHP 8, PECL OCI8 >= 1.1.0)
oci_define_by_name — 將 PHP 變數與查詢提取的欄位關聯
statement由 oci_parse() 建立並由 oci_execute() 執行的有效 OCI8 陳述式識別碼，或 REF CURSOR 陳述式識別碼。
column查詢中使用的欄位名稱。
對於 Oracle 預設的非大小寫敏感欄位名稱，請使用大寫。對於大小寫敏感的欄位名稱，請使用完全相同的欄位名稱大小寫。
var將包含返回欄位值的 PHP 變數。
type要返回的資料類型。通常不需要。請注意，不會執行 Oracle 風格的資料轉換。例如，即使指定 SQLT_INT，返回的資料類型仍將是 SQLT_CHR。
您可以選擇使用 oci_new_descriptor() 來配置 LOB/ROWID/BFILE 描述符。
範例 #1 oci_define_by_name() 範例
<?php
$conn = oci_connect('hr', 'welcome', 'localhost/XE');
if (!$conn) {
$e = oci_error();
trigger_error(htmlentities($e['message'], ENT_QUOTES), E_USER_ERROR);
}
$sql = 'SELECT location_id, city FROM locations WHERE location_id < 1200';
$stid = oci_parse($conn, $sql);
// 必須在執行前定義
oci_define_by_name($stid, 'LOCATION_ID', $locid);
oci_define_by_name($stid, 'CITY', $city);
oci_execute($stid);
// 每次提取都會使用下一行的資料填入先前定義的變數
while (oci_fetch($stid)) {
echo "地點 ID $locid 是 $city<br>\n";
}
// 顯示：
// 地點 ID 1000 是 Roma
// 地點 ID 1100 是 Venice
oci_free_statement($stid);
oci_close($conn);
?>
範例 #2 使用區分大小寫欄位名稱的 oci_define_by_name()
<?php
/*
執行前，請先建立一個包含區分大小寫欄位名稱的表格：
CREATE TABLE mytab (id NUMBER, "MyDescription" VARCHAR2(30));
INSERT INTO mytab (id, "MyDescription") values (1, 'Iced Coffee');
COMMIT;
*/
$conn = oci_connect('hr', 'welcome', 'localhost/XE');
if (!$conn) {
$e = oci_error();
trigger_error(htmlentities($e['message'], ENT_QUOTES), E_USER_ERROR);
}
$stid = oci_parse($conn, 'SELECT * FROM mytab');
// 對於不區分大小寫的欄位名稱，請使用大寫
oci_define_by_name($stid, 'ID', $id);
// 對於區分大小寫的欄位名稱，請使用完全相同的拼寫
oci_define_by_name($stid, 'MyDescription', $mydesc);
oci_execute($stid);
while (oci_fetch($stid)) {
echo "id $id is $mydesc<br>\n";
}
// 顯示：
// id 1 is Iced Coffee
oci_free_statement($stid);
oci_close($conn);
?>
範例 #3 使用 oci_define_by_name() 處理 LOB 欄位
<?php
/*
執行前，請先建立表格：
CREATE TABLE mytab (id NUMBER, fruit CLOB);
INSERT INTO mytab (id, fruit) values (1, 'apple');
INSERT INTO mytab (id, fruit) values (2, 'orange');
COMMIT;
*/
$conn = oci_connect('hr', 'welcome', 'localhost/XE');
if (!$conn) {
$e = oci_error();
trigger_error(htmlentities($e['message'], ENT_QUOTES), E_USER_ERROR);
}
$stid = oci_parse($conn, 'SELECT * FROM mytab');
// 必須在執行前定義
oci_define_by_name($stid, 'ID', $id);
oci_define_by_name($stid, 'FRUIT', $fruit); // $fruit 將會變成一個 LOB 描述子
oci_execute($stid);
while (oci_fetch($stid)) {
echo $id . " is " . $fruit->load(100) . "<br>\n";
}
// 顯示：
// 1 is apple
// 2 is orange
$fruit->free();
oci_free_statement($stid);
oci_close($conn);
?>
範例 #4 使用明確類型的 oci_define_by_name()
<?php
/*
執行前，請先建立表格：
CREATE TABLE mytab (id NUMBER, fruit CLOB);
INSERT INTO mytab (id, fruit) values (1, 'apple');
INSERT INTO mytab (id, fruit) values (2, 'orange');
COMMIT;
*/
$conn = oci_connect('hr', 'welcome', 'localhost/XE');
if (!$conn) {
$e = oci_error();
trigger_error(htmlentities($e['message'], ENT_QUOTES), E_USER_ERROR);
}
$stid = oci_parse($conn, 'SELECT * FROM mytab');
// 必須在執行前定義
oci_define_by_name($stid, 'ID', $id);
$fruit = oci_new_descriptor($conn, OCI_D_LOB);
oci_define_by_name($stid, 'FRUIT', $fruit, OCI_D_CLOB);
oci_execute($stid);
while (oci_fetch($stid)) {
echo $id . " is " . $fruit->load(100) . "<br>\n";
}
// 顯示：
// 1 is apple
// 2 is orange
$fruit->free();
oci_free_statement($stid);
oci_close($conn);
?>