svn: /phpdoc/en/trunk/reference/url/functions/ rawurlencode.xml
| From: | Justin Martin | 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>