On 22 September 2011 15:54, Philip Olson <phi...@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

Reply via email to