oci_num_rows()函数—用法及示例

函数名：oci_num_rows()

适用版本：PHP 5, PHP 7, PHP 8

函数说明：oci_num_rows() 函数用于获取最后一次执行的 SELECT 语句所返回的行数。

语法：oci_num_rows(resource $statement): int|false

参数：

• $statement：一个有效的 OCI 语句资源，通常是通过 oci_parse() 函数返回的结果。

返回值：

• 如果 SELECT 语句执行成功，返回结果集中的行数。
• 如果 SELECT 语句执行失败或者没有查询结果，返回 FALSE。

示例：

// 创建连接
$conn = oci_connect('username', 'password', 'localhost/XE');

// 准备查询语句
$query = 'SELECT * FROM employees WHERE department_id = :dept_id';
$statement = oci_parse($conn, $query);

// 绑定参数
$dept_id = 10;
oci_bind_by_name($statement, ':dept_id', $dept_id);

// 执行查询
oci_execute($statement);

// 获取行数
$row_count = oci_num_rows($statement);

if ($row_count !== false) {
    echo "查询结果中共有 {$row_count} 行数据。\n";
} else {
    echo "查询失败或者没有查询结果。\n";
}

// 关闭连接和释放资源
oci_free_statement($statement);
oci_close($conn);

上述示例中，首先使用 oci_connect() 函数建立与 Oracle 数据库的连接。接着，通过 oci_parse() 函数准备一个查询语句，并使用 oci_bind_by_name() 函数绑定参数。然后，使用 oci_execute() 函数执行查询语句。最后，通过 oci_num_rows() 函数获取查询结果的行数，并根据返回值判断是否成功获取到行数。最后，使用 oci_free_statement() 函数释放语句资源，并使用 oci_close() 函数关闭数据库连接。