archived-doc-de/reference/url/functions/urlencode.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 767338231c3e14c7be5399b8e2e0c3b60f7ae8dd Maintainer: sammywg Status: ready -->
<refentry xml:id="function.urlencode" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <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>string</parameter></methodparam>
  </methodsynopsis>
  <para>
   Diese Funktion ist nützlich als einfache Möglichkeit, eine Zeichenkette zu
   kodieren, die im Abfrageteil einer URL zur Übergabe von Variablen an die
   nächste Seite verwendet werden soll.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>string</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
   unterscheidet sich von der Kodierung nach <link
   xlink:href="&url.rfc;3986">RFC 3986</link> (siehe auch
   <function>rawurlencode</function>) dadurch, dass 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
$userinput = 'Data123!@-_ +';
echo "BenutzerEingabe: $userinput\n";
echo '<a href="mycgi?foo=', urlencode($userinput), '">';
?>
]]>
    </programlisting>
    &example.outputs;
    <screen role="html">
<![CDATA[
BenutzerEingabe: Data123!@-_ +
<a href="mycgi?foo=Data123%21%40-_+%2B">
]]>
    </screen>
   </example>
  </para>
  <para>
   <example>
    <title><function>urlencode</function> und
     <function>htmlentities</function>-Beispiel</title>
    <programlisting role="php">
<![CDATA[
<?php
$foo = 'Data123!@-_ +';
$bar = "Nicht derselbe Inhalt wie $foo";
echo "foo: $foo\n";
echo "bar: $bar\n";
$query_string = 'foo=' . urlencode($foo) . '&bar=' . urlencode($bar);
echo '<a href="mycgi?' . htmlentities($query_string) . '">';
?>
]]>
    </programlisting>
    &example.outputs;
    <screen role="html">
<![CDATA[
foo: Data123!@-_ +
bar: Nicht derselbe Inhalt wie Data123!@-_ +
<a href="mycgi?foo=Data123%21%40-_+%2B&amp;bar=Not+the+same+content+as+Data123%21%40-_+%2B">
]]>
    </screen>
   </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: <link xlink:href="&url.argsep;">&url.argsep;</link>.
   </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>
    <member><link xlink:href="&url.rfc;3986">RFC 3986</link></member>
   </simplelist>
  </para>
 </refsect1>

</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->