函数名称:oci_fetch_object()
适用版本:PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8
函数描述:此函数从结果集中获取下一行作为一个对象,并将其属性设置为列名。
用法: oci_fetch_object(resource $statement, int $type = OCI_BOTH): object|false
参数:
- $statement:一个有效的 OCI 数据库连接资源。
- $type(可选):指定返回对象的类型。默认为 OCI_BOTH,可以是以下值之一:
- OCI_ASSOC:仅返回关联数组。
- OCI_NUM:仅返回索引数组。
- OCI_BOTH:同时返回关联数组和索引数组。
返回值:
- 成功时,返回一个对象,其属性设置为列名;如果没有更多行可用,则返回 false。
示例:
// 假设已建立有效的 OCI 数据库连接
// 准备 SQL 查询语句
$sql = 'SELECT id, name, age FROM users';
// 执行查询
$statement = oci_parse($connection, $sql);
oci_execute($statement);
// 循环获取结果集中的每一行作为对象
while ($row = oci_fetch_object($statement)) {
echo 'ID: ' . $row->ID . '<br>';
echo 'Name: ' . $row->NAME . '<br>';
echo 'Age: ' . $row->AGE . '<br>';
echo '<br>';
}
// 释放资源
oci_free_statement($statement);
oci_close($connection);
注意事项:
- 在执行查询之前,必须使用 oci_parse() 函数准备 SQL 查询语句,并使用 oci_execute() 函数执行查询。
- 调用 oci_fetch_object() 函数后,可以通过对象的属性访问每一列的值。
- 列名区分大小写,因此在访问属性时要与数据库列名保持一致。
- 使用 oci_free_statement() 函数释放语句资源,使用 oci_close() 函数关闭数据库连接。
- 在循环中使用 oci_fetch_object() 可以逐行获取结果集中的数据,直到没有更多行可用为止。