Re: svn: /phpdoc/en/trunk/reference/mysqli/mysqli/ real-escape-string.xml
| From: | Peter Cowburn | Date: | Thu, 22 Sep 2011 15:05:20 +0000 |
| Subject: | Re: svn: /phpdoc/en/trunk/reference/mysqli/mysqli/ real-escape-string.xml | ||
| References: | 1 2 3 4 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969383234@lists.php.net to get a copy of this message | ||
On 22 September 2011 15:54, Philip Olson <philip@roshambo.org> wrote:
>
>>>> + <refsect1 role="notes">
>>>> + &reftitle.notes;
>>>> + <note>
>>>> + <para>
>>>> + For those accustomed to using
>>>> <function>mysql_real_escape_string</function>,
>>>> + note that the arguments of
>>>> <function>mysqli_real_escape_string</function>
>>>> + differ from what <function>mysql_real_escape_string</function>
>>>> expects.
>>>> + The <parameter>link</parameter> identifier comes first in
>>>> + <function>mysqli_real_escape_string</function>, whereas the
>>>> string to be escaped
>>>> + comes first in <function>mysql_real_escape_string</function>.
>>>> + </para>
>>>> + </note>
>>>> + </refsect1>
>>>
>>>
>>> That is true with all the mysql[i]_*() functions.
>>> mysql_ takes the (optional) link identifier as the latter parameter,
>>> while the mysqli_ ones require it - and it is the first parameter..
>>>
>>> With that in mind, is this really needed?
>>
>> Good question. Lets see what the phpdoc list thinks. :)
>
> My initial reaction sees two options:
>
> (1) Add a general comment within the Introduction* about this
> (2) Begin the mysql->mysqli migration guide, by starting with this
>
> I lean towards (2).
That sounds like a plan. Something like this certainly would feel most
at home within a migration guide rather than clogging up many
functions' notes sections.
>
> Regards,
> Philip
>
> * http://php.net/manual/en/intro.mysqli.php