oci_parse

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

oci_parseПодготавливает запрос к выполнению

Описание

resource oci_parse ( resource $connection , string $sql_text )

Подготавливает sql_text к выполнению, используя соединение connection и возвращает идентификатор выражения, который может быть далее использован функциямиoci_bind_by_name(),oci_execute() и другими.

Идентификаторы выражений могут быть освобождены функцией oci_free_statement() или установкой переменной в NULL.

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

connection

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

sql_text

Запрос SQL или PL/SQL.

SQL-запросы не должны заканчиваться точкой с запятой (";"). PL/SQL-запросы должны оканчиваться точкой с запятой (";").

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

Возвращает дескриптор выражения в случае успеха, или FALSE в случае ошибки.

Примеры

Пример #1 Пример использования oci_parse() с SQL-запросами

<?php

$conn 
oci_connect('hr''welcome''localhost/XE');

// Парсинг запроса. Обратите внимание на отсутствие точки запятой в конце SQL-запроса
$stid oci_parse($conn'SELECT * FROM employees');
oci_execute($stid);

echo 
"<table border='1'>\n";
while (
$row oci_fetch_array($stidOCI_ASSOC+OCI_RETURN_NULLS)) {
    echo 
"<tr>\n";
    foreach (
$row as $item) {
        echo 
"    <td>" . ($item !== null htmlentities($itemENT_QUOTES) : "&nbsp;") . "</td>\n";
    }
    echo 
"</tr>\n";
}
echo 
"</table>\n";

?>

Пример #2 Пример использования oci_parse() с PL/SQL-запросами

<?php

/*
  Перед запуском PHP-скрипта, создайте хранимую процедуру в
  SQL*Plus или SQL Developer:

  CREATE OR REPLACE PROCEDURE myproc(p1 IN NUMBER, p2 OUT NUMBER) AS
  BEGIN
      p2 := p1 * 2;
  END;

*/

$conn oci_connect('hr''welcome''localhost/XE');
if (!
$conn) {
    
$e oci_error();
    
trigger_error(htmlentities($e['message'], ENT_QUOTES), E_USER_ERROR);
}

$p1 8;

// При парсинге PL/SQL запросов необходимо наличие точки с запятой в конце строки
$stid oci_parse($conn'begin myproc(:p1, :p2); end;');
oci_bind_by_name($stid':p1'$p1);
oci_bind_by_name($stid':p2'$p240);

oci_execute($stid);

print 
"$p2\n";   // prints 16

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

?>

Примечания

Замечание:

Эта функция не проверяет синтаксис запроса sql_text. Единственный способ проверить правильность SQL или PL/SQL-запроса sql_text - это выполнить его.

Смотрите также

  • oci_execute() - Выполняет подготовленное выражение
  • oci_free_statement() - Освобождает ресурсы, занимаемые курсором или SQL-выражением

Коментарии

Whereas MySQL doesn't care what kind of quotes are around a LIKE clause, ociexecute gives the error:
    ociexecute(): OCIStmtExecute: ORA-00904: "NM": invalid identifier 
for the following.
<?php
$sql 
"SELECT * FROM addresses "
     
"WHERE state LIKE \"NM\""// error!
$stmt ociparse($conn$sql);
ociexecute($stmt);
?>

it's fine if you just use single quotes:
    . "WHERE state LIKE 'NM'";
but i think it's interesting that ociparse doesn't say anything
2003-10-14 22:31:48
http://php5.kiev.ua/manual/ru/function.oci-parse.html
For those that are having trouble with error checking, i have noticed on a lot of sites that people are trying to check the statement handle for error messages with OCIParse. Since the statement handle ($sth) is not created yet, you need to check the database handle ($dbh) for any errors with OCIParse. For example:

instead of:

<?php
$stmt 
OCIParse($conn$query);
if (!
$stmt) {
   
$oerr OCIError($stmt);
   echo 
"Fetch Code 1:".$oerr["message"];
   exit;

?>

use:

<?php
$stmt 
OCIParse($conn$query);
if (!
$stmt) {
   
$oerr OCIError($conn);
   echo 
"Fetch Code 1:".$oerr["message"];
   exit;

?>

Hope this helps someone.
2004-05-04 11:40:14
http://php5.kiev.ua/manual/ru/function.oci-parse.html
A neat way to parse a query only once per script, if the query is done inside a function:

<?php
function querySomething($conn$id)
{
    static 
$stmt;

    if (
is_null($stmt)) {
       
$stmt oci_parse($conn'select * from t where pk = :id');
    }

   
oci_bind_by_name($stmt':id'$id, -1);

   
oci_execute($stmtOCI_DEFAULT);

    return 
oci_fetch_array($stmtOCI_ASSOC);

}

?>

With the static variable, the statment handle isn't closed after the function has terminated. Very nice for functions that are called e.g. in loops. Unfortunately this only works for static sql. If you have dynamic sql, you can do the following:

<?php

function querySomething($conn$data)
{
    static 
$stmt = array();
   
   
$first true;
   
   
$query 'select * from t';

    foreach (
$data as $key => $value) {
        if (
$first) {
           
$first false;
           
$query .= ' where ';
        } else {
           
$query .= ' and ';
        }
       
       
$query .= "$key = :b$key";
    }
   
   
$queryhash md5($query);
   
    if (
is_null($stmt[$queryhash])) {
       
$stmt[$queryhash] = oci_parse($conn$query);   
    }

    foreach (
$data as $key => $value) {
       
// don't use $value, because we bind memory addresses here.
        // this would result in every bind pointing at the same value after foreach
       
oci_bind_by_name($stmt[$queryhash], ":b$key"$data[$key], -1);
    }
   
   
oci_execute($stmt[$queryhash], OCI_DEFAULT);

    return 
oci_fetch_array($stmt[$queryhash], OCI_ASSOC);

}

?>
2007-12-04 10:43:32
http://php5.kiev.ua/manual/ru/function.oci-parse.html
When you want to call stored function (and want to read its result) which executes DML queries (insert, update, delete) inside its body you can't use "select your_stored_function(:param1, :param2) from dual" because you will receive "ORA-14551: cannot perform a DML operation inside a query" error.

In order to call such function and get its result you need to wrap it into nested procedure with OUT parameter like this:

DECLARE
  PROCEDURE caller(return_value OUT NUMBER) AS
  BEGIN
    return_value := your_stored_function(:param1, :param2);
  END;
BEGIN
  caller(:return_value);
END;

and bind to :return_value variable to get the result of function.
2011-02-08 07:38:19
http://php5.kiev.ua/manual/ru/function.oci-parse.html
If you want using PL/SQL in variable:

<?php
$query 
"begin null;  end;";
$stid oci_parse($conn"$query");
 
?>

or 

<?php
$stid 
oci_parse($conn"begin null;  end;");
?>
2015-09-02 18:06:36
http://php5.kiev.ua/manual/ru/function.oci-parse.html

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