Re: svn: /phpdoc/en/trunk/reference/mysqli/mysqli/ real-escape-string.xml
| From: | Philip Olson | Date: | Thu, 22 Sep 2011 14:54:51 +0000 |
| Subject: | Re: svn: /phpdoc/en/trunk/reference/mysqli/mysqli/ real-escape-string.xml | ||
| References: | 1 2 3 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969383232@lists.php.net to get a copy of this message | ||
>>> + <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).
Regards,
Philip
* http://php.net/manual/en/intro.mysqli.php