[函数]oci_fetch_object()函数—用法及示例

函数名称：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() 可以逐行获取结果集中的数据，直到没有更多行可用为止。