Re: svn: /phpdoc/en/trunk/reference/mysqli/mysqli/ real-escape-string.xml

From: 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

« previous php.doc (#969383234) next »