如何使用PHP OCI8从Oracle REF Cursor获取数据？

核心错误原因 #

你的PHP代码存在致命逻辑错误：在连接成功后立即调用了oci_close($conn)，后续所有操作都是基于已关闭的数据库连接，这直接导致了后续的游标操作失败，触发Invalid Fetch或ORA-01008错误。

修复步骤与注意事项 #

1. 修正连接逻辑 #

移除连接成功后的oci_close($conn)语句，保证后续数据库操作使用的是有效连接。

2. 正确执行REF Cursor #

绑定游标并执行主PL/SQL语句后，需要单独执行游标对象才能开始获取数据，即调用oci_execute($result)。

3. 匹配查询列名 #

oci_define_by_name中的列名必须与PL/SQL函数中查询的field1一致，不能写COLUMN_NAME。

4. 完整修复后的PHP代码 #

<?php
// 替换为实际数据库凭证
$database = "(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=192.168.202.238)(PORT=1521))(CONNECT_DATA=(SERVER=DEDICATED)(SERVICE_NAME=PDB1)))";
$username = "***";
$password = "*****";

// 建立连接
$conn = oci_connect($username, $password, $database);

if (!$conn) {
    $error = oci_error();
    echo "连接Oracle失败: " . $error['message'];
    exit;
}
echo "成功连接Oracle数据库！";

// 准备调用存储函数的SQL语句
$sql = "BEGIN :result := test_pkg.getTestData(); END;";
$stmt = oci_parse($conn, $sql);

// 绑定REF CURSOR参数
$result = oci_new_cursor($conn);
oci_bind_by_name($stmt, ':result', $result, -1, OCI_B_CURSOR);

// 执行主语句
oci_execute($stmt);

// 执行游标以获取数据
oci_execute($result);

// 定义列名（与查询的field1一致）
oci_define_by_name($result, 'FIELD1', $fieldValue);

// 遍历游标数据
while (oci_fetch($result)) {
    echo "获取数据: " . $fieldValue . "<br>";
}

// 释放资源
oci_free_statement($stmt);
oci_free_statement($result);
oci_close($conn); 
?>

场景可行性与OCI8相关说明 #

这种通过OCI8调用返回REF Cursor的PL/SQL函数的场景完全可行，OCI8对Oracle REF Cursor的支持是成熟稳定的，不存在普遍的已知兼容性问题。额外需要注意：

• 确保types_package.cursor_type是正确定义的REF CURSOR类型，例如：

  CREATE OR REPLACE PACKAGE types_package AS
      TYPE cursor_type IS REF CURSOR;
  END types_package;
  

• 确认当前数据库用户拥有test_pkg.getTestData函数的执行权限
• 保证WAMP中的OCI8扩展版本与Oracle客户端版本匹配（建议使用与Oracle 19g兼容的OCI8版本）

内容的提问来源于stack exchange，提问作者Vitaly Kravcinsky