oci_new_cursor

(PHP 5, PHP 7, PECL OCI8 >= 1.1.0)

oci_new_cursorВозвращает идентификатор созданного курсора

Описание

resource oci_new_cursor ( resource $connection )

Создает новый курсор для указанного соединения и возвращает его идентификатор.

Список параметров

connection

Идентификатор соединения с сервером Oracle, возвращаемый функцией oci_connect() или oci_pconnect().

Возвращаемые значения

Возвращает указатель на новое выражение или FALSE в случае ошибки.

Примеры

Пример #1 Привязка REF CURSOR в вызове хранимых процедур Oracle

<?php

// Предварительная подготовка:
//   создайте или замените процедуру myproc(myrc out sys_refcursor) как
//   begin
//     open myrc for select first_name from employees;
//   end;

$conn oci_connect("hr""hrpwd""localhost/XE");
if (!
$conn) {
    
$m oci_error();
    
trigger_error(htmlentities($m['message']), E_USER_ERROR);
}

$curs oci_new_cursor($conn);
$stid oci_parse($conn"begin myproc(:cursbv); end;");
oci_bind_by_name($stid":cursbv"$curs, -1OCI_B_CURSOR);
oci_execute($stid);

oci_execute($curs);  // Выполняет REF CURSOR как обычный идентификатор выражения
while (($row oci_fetch_array($cursOCI_ASSOC+OCI_RETURN_NULLS)) != false) {
    echo 
$row['FIRST_NAME'] . "<br />\n";
}

oci_free_statement($stid);
oci_free_statement($curs);
oci_close($conn);

?>

Примечания

Замечание:

В версиях PHP ниже 5.0.0 эта функция называлась ocinewcursor(). В PHP 5.0.0 и выше ocinewcursor() является алиасом oci_new_cursor(), поэтому вы можете продолжать использовать это имя, однако это не рекомендуется.

Коментарии

Because OCI8 uses "prefetching" to greatly improve returning query results, but Oracle doesn't support prefetching for REF CURSORs, application performance using REF CURSORs can be greatly improved by writing a PL/SQL function that pulls data from the REF CURSOR and PIPEs the output. The new function can be queried in a SELECT as if it were a table.  See http://blogs.oracle.com/opal/2008/11/
converting_ref_cursor_to_pipe.html
2008-11-05 14:13:05
http://php5.kiev.ua/manual/ru/function.oci-new-cursor.html
Oracle 11.2 introduced support for REF CURSOR prefetching
2010-01-28 00:41:51
http://php5.kiev.ua/manual/ru/function.oci-new-cursor.html
Some packages in oracle are functions, and that functions returns a cursor.

For example:

CREATE FUNCTION F_Function( p1 char(2), p2 int)
  RETURN SYS_REFCURSOR
AS
  my_cursor SYS_REFCURSOR;
BEGIN
  OPEN my_cursor FOR SELECT * FROM allitems 
                           WHERE (cod=p1) 
                                      AND (Number=p2);
  RETURN my_cursor;
END F_Function; 

Here is the code that allows to obtain data from a function that returns a cursor.

<pre>
<?php
 $conn
=oci_connect("server""user""pass");
if (!
$conn) {
   
$e oci_error();
   
trigger_error(htmlentities($e['message']), E_USER_ERROR);
}

   
//You must asign before.
   
$p1 '03';
   
$p2 2012016191;

   
$stid oci_parse($conn'begin :cursor := server.PKG_package.F_Function(:p1,:p2); end;');
   
$p_cursor oci_new_cursor($conn);

   
//Send parameters variable  value  lenght
   
oci_bind_by_name($stid':p1'$p1,2);
   
oci_bind_by_name($stid':p2'$p2,10);

   
//Bind Cursor     put -1 
   
oci_bind_by_name($stid':cursor'$p_cursor, -1OCI_B_CURSOR);

   
// Execute Statement
   
oci_execute($stid);
   
oci_execute($p_cursorOCI_DEFAULT);

   
oci_fetch_all($p_cursor$cursornullnullOCI_FETCHSTATEMENT_BY_ROW);
    echo 
'<br>';
   
print_r($cursor);
 
?>
2012-11-08 23:15:18
http://php5.kiev.ua/manual/ru/function.oci-new-cursor.html

    Поддержать сайт на родительском проекте КГБ