(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";
}
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 是 $mydesc<br>\n";
}
// 显示：
// id 1 是 Iced Coffee
oci_free_statement($stid);
oci_close($conn);
?>
示例 #3 使用 LOB 列的 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);
oci_define_by_name($stid, 'FRUIT', $fruit); // $fruit 将成为 LOB 描述符
oci_execute($stid);
while (oci_fetch($stid)) {
echo $id . " 是 " . $fruit->load(100) . "<br>\n";
}
// 显示结果：
// 1 是 apple
// 2 是 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 . " 是 " . $fruit->load(100) . "<br>\n";
}
// 显示结果：
// 1 是 apple
// 2 是 orange
$fruit->free();
oci_free_statement($stid);
oci_close($conn);
?>