cvs: phpdoc-de /reference/url/functions http-build-query.xml parse-url.xml rawurldecode.xml rawurlencode.xml urldecode.xml urlencode.xml

From: Date: Thu, 19 Apr 2007 10:58:44 +0000
Subject: cvs: phpdoc-de /reference/url/functions http-build-query.xml parse-url.xml rawurldecode.xml rawurlencode.xml urldecode.xml urlencode.xml
Groups: php.doc.de 
Request: Send a blank email to doc-de+get-2157@lists.php.net to get a copy of this message
sammywg Thu Apr 19 10:58:44 2007 UTC Modified files: /phpdoc-de/reference/url/functions http-build-query.xml parse-url.xml rawurldecode.xml rawurlencode.xml urldecode.xml urlencode.xml Log: update to current en versions

http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/url/functions/http-build-query.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-de/reference/url/functions/http-build-query.xml diff -u phpdoc-de/reference/url/functions/http-build-query.xml:1.3 phpdoc-de/reference/url/functions/http-build-query.xml:1.4 --- phpdoc-de/reference/url/functions/http-build-query.xml:1.3 Wed Sep 20 14:12:23 2006 +++ phpdoc-de/reference/url/functions/http-build-query.xml Thu Apr 19 10:58:44 2007 @@ -1,42 +1,110 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.13 Maintainer: sammywg Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.16 Maintainer: sammywg Status: ready --> <refentry id="function.http-build-query"> <refnamediv> <refname>http_build_query</refname> <refpurpose>Erstellen eines URL-kodierten Query-Strings</refpurpose> </refnamediv> - <refsect1> - <title>Description</title> + <refsect1 role="description"> + &reftitle.description; <methodsynopsis> <type>string</type><methodname>http_build_query</methodname> <methodparam><type>array</type><parameter>formdata</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>numeric_prefix</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>arg_separator</parameter></methodparam> </methodsynopsis> - <simpara> - Erstellt einen URL-kodierten Query-String aus einem gegebenen assoziativem - (oder indexiertem) Array. <parameter>formdata</parameter> kann ein Array - oder ein Objekt sein, das Eigenschaften enthält. Ein - <parameter>formdata</parameter>-Array kann eine einfache eindimensionale - Struktur haben, oder ein Array aus Arrays sein (die wiederum weitere Arrays - enthalten können). Wenn numerische Indizes im äußeren Array verwendet werden - und ein <parameter>numeric_prefix</parameter> angegeben wurde, wird dieser - nur den numerischen Schlüsseln im äußeren Array vorangestellt. Dieser Weg - wurde gewählt, um gültige Variablennamen zu erhalten, wenn die Daten später - von PHP oder einer anderen CGI-Applikation dekodiert werden. - </simpara> + <para> + Erstellt einen URL-kodierten Query-String aus einem gegebenen assoziativen + (oder indexierten) Array. + </para> + </refsect1> - <note> - <para> - <link linkend="ini.arg-separator.output">arg_separator.output</link> wird - verwendet, um die Argumente voneinander zu trennen, es sei denn, dass - <parameter>arg_separator</parameter> angegeben ist. In diesem Falle wird - letzteres verwendet. - </para> - </note> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>formdata</parameter></term> + <listitem> + <para> + Kann ein Array oder ein Objekt sein, das Eigenschaften enthält. + </para> + <para> + Das Array kann eine einfache eindimensionale Struktur haben, oder ein + Array aus Arrays sein (die wiederum weitere Arrays enthalten können). + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>numeric_prefix</parameter></term> + <listitem> + <para> + Wenn numerische Indizes im äußeren Array verwendet werden und ein + <parameter>numeric_prefix</parameter> angegeben wurde, wird dieser nur + den numerischen Schlüsseln im äußeren Array vorangestellt. + </para> + <para> + Dieser Weg wurde gewählt, um gültige Variablennamen zu erhalten, wenn + die Daten später von PHP oder einer anderen CGI-Applikation dekodiert + werden. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>arg_separator</parameter></term> + <listitem> + <para> + <link linkend="ini.arg-separator.output">arg_separator.output</link> wird + verwendet, um die Argumente voneinander zu trennen, es sei denn, dass + der Parameter angegeben ist. In diesem Falle wird letzteres verwendet. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt einen URL-kodierten String zurück. + </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.1.2</entry> + <entry> + <parameter>arg_separator</parameter>-Parameter hinzugefügt. + </entry> + </row> + <row> + <entry>5.1.3</entry> + <entry> + Eckige Klammern werden maskiert. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; <example> <title>Einfache Verwendung von <function>http_build_query</function></title> <programlisting role="php"> @@ -61,21 +129,19 @@ <?php $data = array('foo', 'bar', 'baz', 'boom', 'kuh' => 'milch', 'php' =>'hypertext processor'); -echo http_build_query($data); -/* Ausgabe: - 0=foo&1=bar&2=baz&3=boom&kuh=milch&php=hypertext+processor - */ - +echo http_build_query($data) . "\n"; echo http_build_query($data, 'meineVariable_'); -/* Ausgabe: (fuer bessere Lesbarkeit umgebrochen!) - meineVariable_0=foo&meineVariable_1=bar&meineVariable_2=baz& - meineVariable_3=boom&kuh=milch&php=hypertext+processor - */ ?> ]]> </programlisting> + &example.outputs; + <screen> +<![CDATA[ +0=foo&1=bar&2=baz&3=boom&kuh=milch&php=hypertext+processor +meineVariable_0=foo&meineVariable_1=bar&meineVariable_2=baz&meineVariable_3=boom&kuh=milch&php=hypertext+processor +]]> + </screen> </example> - <example> <title><function>http_build_query</function> mit verschachtelten Arrays</title> <programlisting role="php"> @@ -141,22 +207,20 @@ ]]> </programlisting> </example> + </refsect1> - <note> - <simpara> - Der Parameter <parameter>arg_separator</parameter> wurde mit PHP 5.1.2 - hinzugefügt. - </simpara> - </note> - - <simpara> - Siehe auch - <function>parse_str</function>, - <function>parse_url</function>, - <function>urlencode</function> und - <function>array_walk</function> - </simpara> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>parse_str</function></member> + <member><function>parse_url</function></member> + <member><function>urlencode</function></member> + <member><function>array_walk</function></member> + </simplelist> + </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/url/functions/parse-url.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/url/functions/parse-url.xml diff -u phpdoc-de/reference/url/functions/parse-url.xml:1.6 phpdoc-de/reference/url/functions/parse-url.xml:1.7 --- phpdoc-de/reference/url/functions/parse-url.xml:1.6 Wed Sep 20 14:12:23 2006 +++ phpdoc-de/reference/url/functions/parse-url.xml Thu Apr 19 10:58:44 2007 @@ -1,14 +1,12 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.14 Maintainer: sammywg Status: ready --> -<!-- splitted from ./de/functions/url.xml, last change in rev 1.2 --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.16 Maintainer: sammywg Status: ready --> <refentry id="function.parse-url"> <refnamediv> <refname>parse_url</refname> - <refpurpose> - Analysiert einen URL und gibt seine Bestandteile zurück - </refpurpose> + <refpurpose>Analysiert einen URL und gibt seine Bestandteile zurück</refpurpose> </refnamediv> + <refsect1 role="description"> &reftitle.description; <methodsynopsis> @@ -23,8 +21,8 @@ <para> Diese Funktion ist <emphasis role="strong">nicht</emphasis> dazu gedacht, einen gegebenen URL zu validieren, sondern es gliedert einen URL in die - aufgeführten Bestandteile. Unvollständige URLs werden als Parameter - akzeptiert, <function>parse_url</function> versucht sie bestmöglich zu + unten aufgeführten Bestandteile. Unvollständige URLs werden als Parameter + akzeptiert, <function>parse_url</function> versucht, sie bestmöglich zu analysieren. </para> </refsect1> @@ -186,11 +184,10 @@ </note> <note> <para> - <function>parse_url</function> ist primär dazu gedacht, URLs zu parsen, - nicht jedoch URIs. Um jedoch die Abwärtskompatibilität von PHP zu - gewährleisten, wird für das Schema file:// die Ausnahme dreier Slashes - (file:///) zugelassen. Bei allen anderen Schemata ist diese Notierung - ungültig. + Die Funktion ist primär dazu gedacht, URLs zu parsen, nicht jedoch URIs. Um + jedoch die Abwärtskompatibilität von PHP zu gewährleisten, wird für das + Schema file:// die Ausnahme dreier Slashes (file:///) zugelassen. Bei allen + anderen Schemata ist diese Notierung ungültig. </para> </note> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/url/functions/rawurldecode.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/url/functions/rawurldecode.xml diff -u phpdoc-de/reference/url/functions/rawurldecode.xml:1.5 phpdoc-de/reference/url/functions/rawurldecode.xml:1.6 --- phpdoc-de/reference/url/functions/rawurldecode.xml:1.5 Wed Jan 3 15:30:38 2007 +++ phpdoc-de/reference/url/functions/rawurldecode.xml Thu Apr 19 10:58:44 2007 @@ -1,11 +1,10 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.5 Maintainer: sammywg Status: ready --> -<!-- splitted from ./de/functions/url.xml, last change in rev 1.6 --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.7 Maintainer: sammywg Status: ready --> <refentry id="function.rawurldecode"> <refnamediv> <refname>rawurldecode</refname> - <refpurpose>Dekodierung URL-kodierter Strings</refpurpose> + <refpurpose>Dekodiert URL-kodierte Strings</refpurpose> </refnamediv> <refsect1 role="description"> @@ -19,6 +18,33 @@ Prozentzeichen (<literal>%</literal>) gefolgt von zwei Hex-Werten durch ihr originäres Zeichen ersetzt wurden. </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>str</parameter></term> + <listitem> + <para> + Der zu dekodierende URL. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt den dekodierten URL im Stringformat zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; <para> <example> <title><function>rawurldecode</function>-Beispiel</title> @@ -33,19 +59,29 @@ </programlisting> </example> </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; <note> <para> - <function>rawurldecode</function> dekodiert Pluszeichen ('+') nicht als - Leerzeichen. Dies tut nur <function>urldecode</function>. + <function>rawurldecode</function> verwandelt beim Dekodieren Pluszeichen + ('+') nicht in Leerzeichen. Dies erledigt <function>urldecode</function>. </para> </note> - <simpara> - Siehe auch - <function>rawurlencode</function>, - <function>urldecode</function> und - <function>urlencode</function>. - </simpara> </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>rawurlencode</function></member> + <member><function>urldecode</function></member> + <member><function>urlencode</function></member> + </simplelist> + </para> + </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/url/functions/rawurlencode.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-de/reference/url/functions/rawurlencode.xml diff -u phpdoc-de/reference/url/functions/rawurlencode.xml:1.4 phpdoc-de/reference/url/functions/rawurlencode.xml:1.5 --- phpdoc-de/reference/url/functions/rawurlencode.xml:1.4 Wed Jun 14 17:43:06 2006 +++ phpdoc-de/reference/url/functions/rawurlencode.xml Thu Apr 19 10:58:44 2007 @@ -1,7 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.9 Maintainer: sammywg Status: ready --> -<!-- splitted from ./de/functions/url.xml, last change in rev 1.6 --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.11 Maintainer: sammywg Status: ready --> <refentry id="function.rawurlencode"> <refnamediv> <refname>rawurlencode</refname> @@ -15,18 +14,46 @@ <methodparam><type>string</type><parameter>str</parameter></methodparam> </methodsynopsis> <para> + Kodiert einen übergebenen String entsprechend <ulink + url="&url.rfc;1738">RFC 1738</ulink>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>str</parameter></term> + <listitem> + <para> + Der zu kodierende URL. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> Gibt einen String zurück, in dem alle nicht-alphanumerischen Zeichen außer <literal>-_.</literal> durch ein Prozentzeichen (<literal>%</literal>) gefolgt von zwei Hex-Werten ersetzt wurden. Diese Kodierung, beschrieben im - RFC 1738, wurde entworfen, um Sonderzeichen davor zu bewahren, fälschlich - als spezielle URL-Trennzeichen interpretiert zu werden, sowie um URLs vor - dem Verstümmeln durch Übertragungsmedien mit Zeichenumwandlung (wie bei - einigen E-Mail-Systemen) zu schützen. Wenn Sie beispielsweise ein Passwort - in einen FTP-URL einbinden wollen: + <ulink url="&url.rfc;1738">RFC 1738</ulink>, wurde entworfen, um + Sonderzeichen davor zu bewahren, fälschlich als spezielle URL-Trennzeichen + interpretiert zu werden, sowie um URLs vor dem Verstümmeln durch + Übertragungsmedien mit Zeichenumwandlung (wie bei einigen E-Mail-Systemen) + zu schützen. </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; <para> <example> - <title><function>rawurlencode</function>-Beispiel 1:</title> + <title>Übergeben eines Passworts in einem FTP-URL</title> <programlisting role="php"> <![CDATA[ <?php @@ -35,33 +62,51 @@ ?> ]]> </programlisting> + &example.outputs; + <screen role="html"> +<![CDATA[ +<a href="ftp://user:foo%20%40%2B%25%2F@ftp.example.com/x.txt"> +]]> + </screen> </example> </para> <para> - Oder wenn Sie Informationen über die PATH-INFO-Komponente eines URL - übermitteln wollen: + Oder wenn Sie eine Information innerhalb des PATH_INFO-Teils eines URL + übergeben wollen: </para> <para> <example> - <title><function>rawurlencode</function>-Beispiel 2:</title> + <title><function>rawurlencode</function>-Beispiel 2</title> <programlisting role="php"> <![CDATA[ <?php -echo '<a href="http://example.com/abteilungslisten_skript/', - rawurlencode('Verkauf und Marketing/Miami'), '">'; +echo '<a href="http://example.com/department_list_script/', + rawurlencode('sales and marketing/Miami'), '">'; ?> ]]> </programlisting> + &example.outputs; + <screen role="html"> +<![CDATA[ +<a href="http://example.com/department_list_script/sales%20and%20marketing%2FMiami"> +]]> + </screen> </example> </para> - <simpara> - Siehe auch - <function>rawurldecode</function>, - <function>urldecode</function>, - <function>urlencode</function> und - <ulink url="&url.rfc;1738">RFC 1738</ulink>. - </simpara> </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>rawurldecode</function></member> + <member><function>urldecode</function></member> + <member><function>urlencode</function></member> + <member><ulink url="&url.rfc;1738">RFC 1738</ulink></member> + </simplelist> + </para> + </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/url/functions/urldecode.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-de/reference/url/functions/urldecode.xml diff -u phpdoc-de/reference/url/functions/urldecode.xml:1.3 phpdoc-de/reference/url/functions/urldecode.xml:1.4 --- phpdoc-de/reference/url/functions/urldecode.xml:1.3 Wed Jun 7 17:36:56 2006 +++ phpdoc-de/reference/url/functions/urldecode.xml Thu Apr 19 10:58:44 2007 @@ -1,26 +1,53 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.4 Maintainer: sammywg Status: ready --> -<!-- splitted from ./de/functions/url.xml, last change in rev 1.2 --> - <refentry id="function.urldecode"> - <refnamediv> - <refname>urldecode</refname> - <refpurpose>Dekodiert eine URL-kodierte Zeile</refpurpose> - </refnamediv> - - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>urldecode</methodname> - <methodparam><type>string</type><parameter>str</parameter></methodparam> - </methodsynopsis> - <para> - Dekodiert jede <literal>%<replaceable>##</replaceable></literal> - Kodierung einer gegebenen Zeichenkette. Der dekodierte String wird - zurückgegeben. - <example> - <title><function>urldecode</function>-Beispiel</title> - <programlisting role="php"> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.6 Maintainer: sammywg Status: ready --> +<refentry id="function.urldecode"> + <refnamediv> + <refname>urldecode</refname> + <refpurpose>Dekodiert eine URL-kodierte Zeichenkette</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>urldecode</methodname> + <methodparam><type>string</type><parameter>str</parameter></methodparam> + </methodsynopsis> + <para> + Dekodiert jede <literal>%<replaceable>##</replaceable></literal> + Kodierung einer gegebenen Zeichenkette. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>str</parameter></term> + <listitem> + <para> + Der zu dekodierende String. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt den dekodierten String zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>urldecode</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php $a = explode('&', $QUERY_STRING); @@ -33,17 +60,23 @@ } ?> ]]> - </programlisting> - </example> - </para> - <para> - Siehe auch - <function>urlencode</function>, - <function>rawurlencode</function> und - <function>rawurldecode</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>urlencode</function></member> + <member><function>rawurlencode</function></member> + <member><function>rawurldecode</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/url/functions/urlencode.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/url/functions/urlencode.xml diff -u phpdoc-de/reference/url/functions/urlencode.xml:1.6 phpdoc-de/reference/url/functions/urlencode.xml:1.7 --- phpdoc-de/reference/url/functions/urlencode.xml:1.6 Mon Jan 15 14:31:18 2007 +++ phpdoc-de/reference/url/functions/urlencode.xml Thu Apr 19 10:58:44 2007 @@ -1,84 +1,125 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.9 Maintainer: sammywg Status: ready --> -<!-- splitted from ./de/functions/url.xml, last change in rev 1.2 --> - <refentry id="function.urlencode"> - <refnamediv> - <refname>urlencode</refname> - <refpurpose>URL-kodiert einen String</refpurpose> - </refnamediv> - - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>urlencode</methodname> - <methodparam><type>string</type><parameter>str</parameter></methodparam> - </methodsynopsis> - <para> - Gibt einen String zurück, in dem alle nicht alphanumerischen Zeichen - bis auf <literal>-_.</literal> durch das Prozentzeichen - (<literal>%</literal>) gefolgt von zwei Hexzeichen sowie Leerzeichen durch - ein Pluszeichen (<literal>+</literal>) ersetzt werden. Genauso werden auch - Daten kodiert, die über ein WWW-Formular gesendet werden, dies entspricht - dem Media Type <literal>application/x-www-form-urlencoded</literal>. - Die Umsetzung des Leerzeichens zum Pluszeichen (+) hat - historische Gründe und stellt den Unterschied zur Kodierung - nach RFC1738 (siehe <function>rawurlencode</function>) dar, bei der das - Leerzeichen als %20 kodiert wird. Die Funktion urlencode() ist - sehr nützlich, um einen String zu kodieren, der im Queryteil - einer URL verwendet werden soll. Der Queryteil ist eine - bequeme Art, Variablen an die nächste Seite zu übergeben: - <example> - <title><function>urlencode</function>-Beispiel</title> - <programlisting role="php"> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.11 Maintainer: sammywg Status: ready --> +<refentry id="function.urlencode"> + <refnamediv> + <refname>urlencode</refname> + <refpurpose>URL-kodiert einen String</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>urlencode</methodname> + <methodparam><type>string</type><parameter>str</parameter></methodparam> + </methodsynopsis> + <para> + Die Funktion ist geeignet, wenn ein String innerhalb eines Queryparts eines + URL verwendet werden soll, und man einen komfortablen Weg benötigt, Variablen + an die nächste Seite zu übergeben. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>str</parameter></term> + <listitem> + <para> + Der zu kodierende String. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt einen String zurück, in dem alle nicht-alphanumerischen Zeichen außer + <literal>-_.</literal> durch ein Prozentzeichen (<literal>%</literal>) + gefolgt von zwei Hexadezimalwerten und Leerzeichen durch ein Plus + (<literal>+</literal>) ersetzt werden. Das Encoding geschieht auf dem + gleichen Wege, wie auch durch ein WWW-Formular gepostete Daten kodiert + werden - das entspricht der Auszeichnung des Dateityps + <literal>application/x-www-form-urlencoded</literal>. Diese Auszeichnung + differiert von der Kodierung nach <ulink url="&url.rfc;1738">RFC 1738</ulink> + (siehe auch <function>rawurlencode</function>), bei der aus historischen + Gründen das Leerzeichen als Pluszeichen (+) kodiert wird. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>urlencode</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php echo '<a href="mycgi?foo=', urlencode($userinput), '">'; ?> ]]> - </programlisting> - </example> - </para> - <para> - Beachten Sie: Seien Sie vorsichtig bei der Verwendung von Variablen, die - HTML-Sonderzeichen enthalten. Zeichen wie &amp;amp, &amp;copy und - &amp;pound werden vom Browser geparst und das betreffende echte Zeichen - statt des HTML-Namens verwendet. Dies ist eine offensichtliche - Schwierigkeit, die das W3C seit Jahren zu verdeutlichen sucht. Die - entsprechende Referenz finden Sie hier: - <ulink url="&url.argsep;">&url.argsep;</ulink>. PHP lässt die Umstellung - des Argument-Separators auf das W3C-empfohlene Semikolon mittels der - .ini-Direktive arg_separator zu. Bedauerlicherweise senden die meisten - User Agents Formulardaten nicht in diesem durch Semikolon getrennten - Format. Ein möglicher Weg das zu umgehen, ist, &amp;amp anstatt &amp; als - Separator zu verwenden. Sie brauchen dafür die PHP-Option arg_separator - nicht zu ändern. Belassen Sie sie auf &amp; und kodieren Sie dafür Ihre - URL unter Verwendung von <function>htmlentities</function> oder - <function>htmlspecialchars</function>. - </para> - <para> - <example> - <title><function>urlencode</function> und - <function>htmlentities</function>-Beispiel</title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + <example> + <title><function>urlencode</function> und + <function>htmlentities</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php $query_string = 'foo=' . urlencode($foo) . '&bar=' . urlencode($bar); echo '<a href="mycgi?' . htmlentities($query_string) . '">'; ?> ]]> - </programlisting> - </example> - </para> - <para> - Siehe auch - <function>urldecode</function>, - <function>htmlentities</function>, - <function>rawurldecode</function> und - <function>rawurlencode</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + <note> + <para> + Seien Sie vorsichtig beim Umgang mit Variablen, die HTML-Entities enthalten + könnten. Angaben wie &amp;amp, &amp;copy und &amp;pound werden vom Browser + geparst und die eigentliche Entität wird anstelle des gewünschten + Variablennamens verwendet. Dies ist eine naheliegende Schwierigkeit, über + die das W3C bereits seit Jahren informiert. Die entsprechende Referenz + finden Sie hier: <ulink url="&url.argsep;">&url.argsep;</ulink>. + </para> + <para> + PHP unterstützt den Austausch des vom W3C empfohlenen Argument-Trenners + Semikolon durch einen selbstgewählten Trenner über die + arg_separator-Direktive in der php.ini. Leider senden die meisten + User-Agents Formulardaten nicht im standardkonformen semikolongetrennten + Format. Ein möglicher Weg, mit diesem Problem umzugehen, ist die Verwendung + von &amp;amp; anstelle von &amp; als Trennzeichen. Sie müssen dafür nicht + die php.ini-Direktive arg_separator verändern. Belassen Sie sie als &amp;, + und verwenden Sie statt dessen für Ihre URLs die Funktionen + <function>htmlentities</function> oder <function>htmlspecialchars</function>. + </para> + </note> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>urldecode</function></member> + <member><function>htmlentities</function></member> + <member><function>rawurlencode</function></member> + <member><function>rawurldecode</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file
« previous php.doc.de (#2157) next »