svn: /phpdoc/en/trunk/reference/url/functions/ rawurlencode.xml

From: Date: Sat, 06 Nov 2010 19:12:47 +0000
Subject: svn: /phpdoc/en/trunk/reference/url/functions/ rawurlencode.xml
Groups: php.doc.cvs 
Request: Send a blank email to doc-cvs+get-7378@lists.php.net to get a copy of this message
frozenfire Sat, 06 Nov 2010 19:12:47 +0000 Revision: http://svn.php.net/viewvc?view=revision&revision=305134 Log: Updated to reflect RFC 3986, as per bug #53187. Bug: http://bugs.php.net/53187 (Open) urlencode and ~ encodes differently in the various versions of the functions Changed paths: U phpdoc/en/trunk/reference/url/functions/rawurlencode.xml Modified: phpdoc/en/trunk/reference/url/functions/rawurlencode.xml =================================================================== --- phpdoc/en/trunk/reference/url/functions/rawurlencode.xml 2010-11-06 18:35:38 UTC (rev 305133) +++ phpdoc/en/trunk/reference/url/functions/rawurlencode.xml 2010-11-06 19:12:47 UTC (rev 305134) @@ -3,7 +3,7 @@ <refentry xml:id="function.rawurlencode" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>rawurlencode</refname> - <refpurpose>URL-encode according to RFC 1738</refpurpose> + <refpurpose>URL-encode according to RFC 3986</refpurpose> </refnamediv> <refsect1 role="description"> @@ -14,7 +14,7 @@ </methodsynopsis> <para> Encodes the given string according to <link - xlink:href="&url.rfc;1738">RFC 1738</link>. + xlink:href="&url.rfc;3986">RFC 3986</link>. </para> </refsect1> @@ -38,14 +38,44 @@ &reftitle.returnvalues; <para> Returns a string in which all non-alphanumeric characters except - <literal>-_.</literal> have been replaced with a percent + <literal>-_.~</literal> have been replaced with a percent (<literal>%</literal>) sign followed by two hex digits. This is the - encoding described in <link xlink:href="&url.rfc;1738">RFC 1738</link> for + encoding described in <link xlink:href="&url.rfc;3986">RFC 3986</link> for protecting literal characters from being interpreted as special URL delimiters, and for protecting URLs from being mangled by transmission - media with character conversions (like some email systems). + media with character conversions (like some email systems). + <note> + <para> + Prior to PHP 5.3.0, rawurlencode encoded tildes (<literal>~</literal>) as per + <link xlink:href="&url.rfc;1738">RFC 1738</link>. + </para> + </note> </para> </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>5.3.0</entry> + <entry> + Now conforms to <link xlink:href="&url.rfc;3986">RFC 3986</link>. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> <refsect1 role="examples"> &reftitle.examples; @@ -99,7 +129,7 @@ <member><function>rawurldecode</function></member> <member><function>urldecode</function></member> <member><function>urlencode</function></member> - <member><link xlink:href="&url.rfc;1738">RFC 1738</link></member> + <member><link xlink:href="&url.rfc;3986">RFC 3986</link></member> </simplelist> </para> </refsect1>

« previous php.doc.cvs (#7378) next »