cvs: phpdoc-ru /reference/oci8/functions oci-parse.xml phpdoc/en/reference/oci8/functions oci-parse.xml
| From: | Antony Dovgal | 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>