cvs: phpdoc-ru /reference/oci8/functions oci-parse.xml phpdoc/en/reference/oci8/functions oci-parse.xml

From: Date: Thu, 25 Mar 2004 08:24:14 +0000
Subject: cvs: phpdoc-ru /reference/oci8/functions oci-parse.xml phpdoc/en/reference/oci8/functions oci-parse.xml
Groups: php.doc.ru 
Request: Send a blank email to doc-ru+get-263@lists.php.net to get a copy of this message
tony2001 Thu Mar 25 03:24:14 2004 EDT Modified files: /phpdoc/en/reference/oci8/functions oci-parse.xml /phpdoc-ru/reference/oci8/functions oci-parse.xml Log: fix bug #27672 (oci_parse doesn't validate query indeed, it only prepares and returns statement identifier) http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/oci-parse.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc/en/reference/oci8/functions/oci-parse.xml diff -u phpdoc/en/reference/oci8/functions/oci-parse.xml:1.1 phpdoc/en/reference/oci8/functions/oci-parse.xml:1.2 --- phpdoc/en/reference/oci8/functions/oci-parse.xml:1.1 Mon Mar 8 09:12:17 2004 +++ phpdoc/en/reference/oci8/functions/oci-parse.xml Thu Mar 25 03:24:12 2004 @@ -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> http://cvs.php.net/diff.php/phpdoc-ru/reference/oci8/functions/oci-parse.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc-ru/reference/oci8/functions/oci-parse.xml diff -u phpdoc-ru/reference/oci8/functions/oci-parse.xml:1.1 phpdoc-ru/reference/oci8/functions/oci-parse.xml:1.2 --- phpdoc-ru/reference/oci8/functions/oci-parse.xml:1.1 Tue Mar 16 07:47:26 2004 +++ phpdoc-ru/reference/oci8/functions/oci-parse.xml Thu Mar 25 03:24:13 2004 @@ -1,9 +1,9 @@ <?xml version="1.0" encoding="windows-1251"?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> <refentry id="function.oci-parse"> <refnamediv> <refname>oci_parse</refname> - <refpurpose>Îáðàáàòûâàåò çàïðîñ è âîçâðàùàåò èäåíòèôèêàòîð âûðàæåíèÿ</refpurpose> + <refpurpose>Ïîäãîòàâëèâàåò çàïðîñ ê âûïîëíåíèþ</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> @@ -12,14 +12,23 @@ <methodparam><type>resource</type><parameter>connection</parameter></methodparam> <methodparam><type>string</type><parameter>query</parameter></methodparam> </methodsynopsis> - <simpara> - <function>oci_parse</function> îáðàáàòûâàåò <parameter>query</parameter>, + <para> + <function>oci_parse</function> ïîäãîòàâëèâàåò + <parameter>query</parameter> ê âûïîëíåíèþ, èñïîëüçóÿ ñîåäèíåíèå <parameter>connection</parameter> è - âîçâðàùàåò èäåíòèôèêàòîð âûðàæåíèÿ, åñëè çàïðîñ - <parameter>query</parameter> ñèíòàêñè÷åñêè ïðàâèëåí èëè &false; â ñëó÷àå - îøèáêè. Ïàðàìåòð <parameter>query</parameter> ìîæåò áûòü âûðàæåíèåì SQL - èëè íàáîðîì êîìàíä PL/SQL. - </simpara> + âîçâðàùàåò èäåíòèôèêàòîð âûðàæåíèÿ. Ïàðàìåòð <parameter>query</parameter> + ìîæåò áûòü âûðàæåíèåì SQL èëè íàáîðîì êîìàíä PL/SQL. + </para> + <note> + <para> + Ýòà ôóíêöèÿ <emphasis>íå ïðîâåðÿåò</emphasis> ñèíòàêñèñ çàïðîñà + <parameter>query</parameter>. Åäèíñòâåííûé ñïîñîá ïðîâåðèòü ïðàâèëüíîñòü + çàïðîñà - ýòî âûïîëíèòü åãî. + </para> + </note> + <para> + <function>oci_parse</function> âîçâðàùàåò &false; â ñëó÷àå îøèáêè. + </para> </refsect1> </refentry>

« previous php.doc.ru (#263) next »