ocinewcursor

(PHP 3>= 3.0.8, PHP 4 , PHP 5)

ocinewcursor --  Return a new cursor (Statement-Handle)

Description

resource ocinewcursor ( resource conn )

ocinewcursor() allocates a new statement handle on the specified connection.

Example 1. Using a REF CURSOR from a stored procedure in Oracle

<?php   
// suppose your stored procedure info.output returns a ref cursor in :data

$conn = OCILogon("scott", "tiger");
$curs = OCINewCursor($conn);
$stmt = OCIParse($conn, "begin info.output(:data); end;");

ocibindbyname($stmt, "data", $curs, -1, OCI_B_CURSOR);
ociexecute($stmt);
ociexecute($curs);

while (
OCIFetchInto($curs, $data)) {
    
var_dump($data);
}

OCIFreeStatement($stmt);
OCIFreeCursor($curs);
OCILogoff($conn);
?>

Example 2. Using a REF CURSOR in a select statement in Oracle

<?php   
echo "<html><body>";
$conn = OCILogon("scott", "tiger");
$count_cursor = "CURSOR(select count(empno) num_emps from emp " .
                
"where emp.deptno = dept.deptno) as EMPCNT from dept";
$stmt = OCIParse($conn, "select deptno,dname,$count_cursor");

ociexecute($stmt);
echo
"<table border=\"1\">";
echo
"<tr>";
echo
"<th>DEPT NAME</th>";
echo
"<th>DEPT #</th>";
echo
"<th># EMPLOYEES</th>";
echo
"</tr>";

while (
OCIFetchInto($stmt, &$data, OCI_ASSOC)) {
    echo
"<tr>";
    
$dname  = $data["DNAME"];
    
$deptno = $data["DEPTNO"];
    echo
"<td>$dname</td>";
    echo
"<td>$deptno</td>";
    
ociexecute($data["EMPCNT"]);
    while (
OCIFetchInto($data["EMPCNT"], &$subdata, OCI_ASSOC)) {
        
$num_emps = $subdata["NUM_EMPS"];
        echo  
"<td>$num_emps</td>";
    }
    echo
"</tr>";
}
echo
"</table>";
echo
"</body></html>";
OCIFreeStatement($stmt);
OCILogoff($conn);
?>

Note: This function was renamed to oci_new_cursor() after PHP >= 5.0.0. For downward compatibility ocinewcursor() can also be used. This is deprecated, however.