fix bug #27672 (oci_parse doesn't validate query indeed, it only prepares and returns statement identifier)

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@154543 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Antony Dovgal 2004-03-25 08:24:12 +00:00
parent 9125bb167c
commit 4cf9520cf2

View file

@ -1,9 +1,9 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- $Revision: 1.2 $ -->
<refentry id="function.oci-parse">
<refnamediv>
<refname>oci_parse</refname>
<refpurpose>Parses a query and returns an Oracle statement identifier</refpurpose>
<refpurpose>Prepares Oracle statement for execution</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
@ -13,12 +13,20 @@
<methodparam><type>string</type><parameter>query</parameter></methodparam>
</methodsynopsis>
<para>
<function>oci_parse</function> parses the <parameter>query</parameter>
<function>oci_parse</function> prepares the <parameter>query</parameter>
using <parameter>connection</parameter> and returns the statement
identifier if the <parameter>query</parameter> is valid or &false; if not.
The <parameter>query</parameter> can be any valid SQL statement or PL/SQL
block.
identifier, which can be used with
<function>oci_bind_by_name</function>, <function>oci_execute</function>
and other functions.
</para>
<note>
<para>
This function <emphasis>does not</emphasis> validate
<parameter>query</parameter>. The only way to find out if
<parameter>query</parameter> is valid SQL or PL/SQL statement - is to
execute it.
</para>
</note>
<para>
<function>oci_parse</function> returns &false; on error.
</para>