cvs: phpdoc /en/reference/url/functions get-meta-tags.xml parse-url.xml rawurldecode.xml rawurlencode.xml urlencode.xml

derick Mon Jun 16 16:11:10 2003 EDT Modified files: /phpdoc/en/reference/url/functions get-meta-tags.xml parse-url.xml rawurldecode.xml rawurlencode.xml urlencode.xml Log: - Layout Index: phpdoc/en/reference/url/functions/get-meta-tags.xml diff -u phpdoc/en/reference/url/functions/get-meta-tags.xml:1.3 phpdoc/en/reference/url/functions/get-meta-tags.xml:1.4 --- phpdoc/en/reference/url/functions/get-meta-tags.xml:1.3 Tue Jan 21 16:23:04 2003 +++ phpdoc/en/reference/url/functions/get-meta-tags.xml Mon Jun 16 16:11:10 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/strings.xml, last change in rev 1.2 --> <refentry id="function.get-meta-tags"> <refnamediv> @@ -59,7 +59,7 @@ <programlisting role="php"> <![CDATA[ <?php -// Assuming the above tags are at example.com +// Assuming the above tags are at www.example.com $tags = get_meta_tags('http://www.example.com/'); // Notice how the keys are all lowercase now, and @@ -76,7 +76,7 @@ <note> <para> As of PHP 4.0.5, <function>get_meta_tags</function> supports - unquoted html attributes. + unquoted HTML attributes. </para> </note> <para> Index: phpdoc/en/reference/url/functions/parse-url.xml diff -u phpdoc/en/reference/url/functions/parse-url.xml:1.5 phpdoc/en/reference/url/functions/parse-url.xml:1.6 --- phpdoc/en/reference/url/functions/parse-url.xml:1.5 Thu Oct 17 20:25:49 2002 +++ phpdoc/en/reference/url/functions/parse-url.xml Mon Jun 16 16:11:10 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> +<!-- $Revision: 1.6 $ --> <!-- splitted from ./en/functions/url.xml, last change in rev 1.2 --> <refentry id="function.parse-url"> <refnamediv> @@ -65,7 +65,7 @@ parse them correctly. </para> <example> - <title>Using <function>parse_url</function></title> + <title><function>parse_url</function> example</title> <screen> $ php -r 'print_r( parse_url("http://username:password@hostname/path?arg=value#anchor"));' Array Index: phpdoc/en/reference/url/functions/rawurldecode.xml diff -u phpdoc/en/reference/url/functions/rawurldecode.xml:1.2 phpdoc/en/reference/url/functions/rawurldecode.xml:1.3 --- phpdoc/en/reference/url/functions/rawurldecode.xml:1.2 Wed Apr 17 02:44:55 2002 +++ phpdoc/en/reference/url/functions/rawurldecode.xml Mon Jun 16 16:11:10 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/url.xml, last change in rev 1.6 --> <refentry id="function.rawurldecode"> <refnamediv> @@ -16,7 +16,8 @@ Returns a string in which the sequences with percent (<literal>%</literal>) signs followed by two hex digits have been replaced with literal characters. For example, the string - <screen>foo%20bar%40baz</screen> decodes into <screen>foo bar@baz</screen>. + <literal>foo%20bar%40baz</literal> decodes into <literal>foo + bar@baz</literal>. </para> <note> <para> Index: phpdoc/en/reference/url/functions/rawurlencode.xml diff -u phpdoc/en/reference/url/functions/rawurlencode.xml:1.4 phpdoc/en/reference/url/functions/rawurlencode.xml:1.5 --- phpdoc/en/reference/url/functions/rawurlencode.xml:1.4 Wed May 7 17:31:31 2003 +++ phpdoc/en/reference/url/functions/rawurlencode.xml Mon Jun 16 16:11:10 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./en/functions/url.xml, last change in rev 1.6 --> <refentry id="function.rawurlencode"> <refnamediv> @@ -14,7 +14,7 @@ </methodsynopsis> <para> Returns a string in which all non-alphanumeric characters except - <screen>-_.</screen> 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 RFC 1738 for protecting literal characters from being interpreted as special URL delimiters, and Index: phpdoc/en/reference/url/functions/urlencode.xml diff -u phpdoc/en/reference/url/functions/urlencode.xml:1.4 phpdoc/en/reference/url/functions/urlencode.xml:1.5 --- phpdoc/en/reference/url/functions/urlencode.xml:1.4 Wed Feb 19 19:29:28 2003 +++ phpdoc/en/reference/url/functions/urlencode.xml Mon Jun 16 16:11:10 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./en/functions/url.xml, last change in rev 1.2 --> <refentry id="function.urlencode"> <refnamediv> @@ -35,19 +35,21 @@ </example> </para> <para> - Note: Be careful about variables that may match HTML entities. - Things like &amp;amp, &amp;copy and &amp;pound are parsed by the - browser and the actual entity is used instead of the desired - variable name. This is an obvious hassle that the W3C has been - telling people about for years. The reference is here: - <ulink url="&url.argsep;">&url.argsep;</ulink> PHP supports - changing the argument separator to the W3C-suggested semi-colon - through the arg_separator .ini directive. Unfortunately most user - agents do not send form data in this semi-colon separated format. - A more portable way around this is to use &amp;amp; instead of - &amp; as the separator. You don't need to change PHP's - arg_separator for this. Leave it as &amp;, but simply encode - your URLs using <function>htmlentities</function>(urlencode($data)). + Note: Be careful about variables that may match HTML entities. + Things like &amp;amp, &amp;copy and &amp;pound are parsed by the + browser and the actual entity is used instead of the desired + variable name. This is an obvious hassle that the W3C has been + telling people about for years. The reference is here: + <ulink url="&url.argsep;">&url.argsep;</ulink> PHP supports + changing the argument separator to the W3C-suggested semi-colon + through the arg_separator .ini directive. Unfortunately most user + agents do not send form data in this semi-colon separated format. + A more portable way around this is to use &amp;amp; instead of + &amp; as the separator. You don't need to change PHP's + arg_separator for this. Leave it as &amp;, but simply encode + your URLs using htmlentities(urlencode($data)). + </para> + <para> <example> <title><function>urlencode</function> and <function>htmlentities</function> example</title> <programlisting role="php">