<?xml version="1.0" encoding="iso-8859-2"?>
<!-- EN-Revision: 1.26 Maintainer: adi Status: ready -->
<!-- $Revision: 1.10 $ -->
 <reference id="ref.url">
  <title>URL</title>
  <titleabbrev>URLs</titleabbrev>

  <refentry id="function.base64-decode">
   <refnamediv>
    <refname>base64_decode</refname>
    <refpurpose>Dekoduje dane zakodowane algorytmem MIME base64</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>string</type><methodname>base64_decode</methodname>
      <methodparam><type>string</type><parameter>dane_zakodowane</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>base64_decode</function> dekoduje
     <parameter>dane_zakodowane</parameter> i zwraca oryginaln posta
      danych. Dane wynikowe mog by binarne.
    </para>
    <para>
     Patrz take: <function>base64_encode</function>, RFC2045 sekcja
     6.8.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.base64-encode">
   <refnamediv>
    <refname>base64_encode</refname>
    <refpurpose>Koduje dane za pomoc algorytmu MIME base64</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>string</type><methodname>base64_encode</methodname>
      <methodparam><type>string</type><parameter>dane</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>base64_encode</function> zwraca
     <parameter>dane</parameter> zakodowane za pomoc algorytmu base64.
     Ten sposb kodowania zosta zaprojektowany, aby mc bezpiecznie
     przesya dane binarne, poprzez warstwy transportujce nie
     zaprojektowane do obsugi 8 bitowego przesyania informacji, np.
     tre email'i.
    </para>
    <para>
     Dane zakodowane t funkcj zajmuj ok 33% wicej miejsca ni dane
     oryginalne.
    </para>
    <para>
     Patrz take:
     <function>base64_decode</function>,
     <function>chunk_split</function>,
     RFC2045 sekcja 6.8.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.parse-url">
   <refnamediv>
    <refname>parse_url</refname>
    <refpurpose>Przetwarza adres URL i zwraca jego skadowe</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>array</type><methodname>parse_url</methodname>
      <methodparam><type>string</type><parameter>url</parameter></methodparam>
     </methodsynopsis>
    <para>
     Funkcja ta zwraca w tablicy asocjacyjnej wszystkie skadowe
     przetwarzanego URL'a.
     Dostpne s nastpujce klucze tablicy:
     "scheme" (protok), "host", "port", "user" (uytkownik), "pass" (haso),
     "path" (cieka), "query" (zapytanie) i "fragment" (tre kotwicy, po #).
    </para>
    <para>
     Patrz take <function>pathinfo</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.rawurldecode">
   <refnamediv>
    <refname>rawurldecode</refname>
    <refpurpose>Dekoduje acuchy zakodowane metod kodowania URL'i</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>string</type><methodname>rawurldecode</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Zwraca acuch w ktrym sekwencje dwch cyfr szesnastkowych
     poprzedzone znakiem procenta (<literal>%</literal>), zastpione
     s przez ich odpowiednik znakowy. Na przykad, acuch
     <screen>foo%20bar%40baz</screen> zostanie odkodowany do postaci
     <screen>foo bar@baz</screen>.
    </para>
    <note>
     <para>
      <function>rawurldecode</function> nie zamienia znakw plusa ('+')
      na spacje. Robi to <function>urldecode</function>.
     </para>
    </note>
    <simpara>
     Patrz take <function>rawurlencode</function>,
     <function>urldecode</function>,
     <function>urlencode</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.rawurlencode">
   <refnamediv>
    <refname>rawurlencode</refname>
    <refpurpose>Koduje URL'e zgodnie z RFC1738</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>string</type><methodname>rawurlencode</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Zwraca acuch w ktrym wszystkie nie alfanumeryczne znaki
     z wyjtkiem <screen>-_.</screen> zostay zastpione przez
     dwie cyfry szesnastkowe poprzedzone znakiem procenta
     (<literal>%</literal>). Ten sposb kodowania zosta opisany
     w RFC1738. Zabezpiecza dane wejciowe przed zinterpretowaniem
     ich jako znaki specjalne URL'a oraz zabezpiecza URL'e przed
     znieksztaceniem ich podczas konwersji znakw dokonywanych
     przez media transmisyjne (np. niektre systemy pocztowe).
     Na przykad, jeli chcesz doczy haso do URL'a FTP:
    </para>
    <example>
     <title><function>rawurlencode</function> przykad 1</title>
     <programlisting role="php">
<![CDATA[
echo '<a href="ftp://user:', rawurlencode('foo @+%/'),
     '@ftp.my.com/x.txt">';
]]>
     </programlisting>
    </example>
    <para>
     Lub, jeli podajesz informacj w czci PATH_INFO (cieka) URL'a:
    </para>
    <example>
     <title><function>rawurlencode</function> przykad 2</title>
     <programlisting role="php">
<![CDATA[
echo '<a href="http://x.com/department_list_script/',
    rawurlencode('sales and marketing/Miami'), '">';
]]>
     </programlisting>
    </example>
    <simpara>
     Patrz take <function>rawurldecode</function>,
     <function>urldecode</function>,
     <function>urlencode</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.urldecode">
   <refnamediv>
    <refname>urldecode</refname>
    <refpurpose>Dekoduje acuchy zakodowane metod kodowania URL'i</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>string</type><methodname>urldecode</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Odkodowuje kady <literal>%<replaceable>##</replaceable></literal>
     kod z danego acucha.  Zwracany jest zdekodowany acuch.
     <example>
      <title><function>urldecode</function> przykad</title>
      <programlisting role="php">
<![CDATA[
$a = explode('&', $QUERY_STRING);
$i = 0;
while ($i < count($a)) {
    $b = split('=', $a[$i]);
    echo 'Warto parametru ', htmlspecialchars(urldecode($b[0])),
         ' wynosi ', htmlspecialchars(urldecode($b[1])), "<br />\n";
    $i++;
}
]]>
      </programlisting>
     </example>
    </para>
    <para>
     Patrz take <function>urlencode</function>,
     <function>rawurlencode</function>,
     <function>rawurldecode</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.urlencode">
   <refnamediv>
    <refname>urlencode</refname>
    <refpurpose>Koduje acuch metod kodowania URLi</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>string</type><methodname>urlencode</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Zwraca acuch w ktrym wszystkie nie alfanumeryczne znaki
     z wyjtkiem <screen>-_.</screen> zostay zastpione przez
     dwie cyfry szesnastkowe poprzedzone znakiem procenta
     (<literal>%</literal>), a spacje kodowane s jako znak
     (<literal>+</literal>). To kodowanie jest takie same jak
     wykorzystywane przy przesyaniu danych z formularzy WWW, tj.
     takie samo jak w media typie:
     <literal>application/x-www-form-urlencoded</literal>.
     Rni si od kodowania z RFC1738 (zobacz
     <function>rawurlencode</function>) tym, e z powodw historycznych,
     spacje s kodowane jako znak plus (+).  Funkcja ta jest odpowiednia
     do zakodowania acucha uywanego w zapytaniu URL oraz
     jako zmienna przekazywana do nastpnej strony:
     <example>
      <title><function>urlencode</function> przykad</title>
      <programlisting role="php">
<![CDATA[
echo '<a href="mycgi?foo=', urlencode($userinput), '">';
]]>
      </programlisting>
     </example>
    </para>
    <para>
    Notka: Uwaaj na zmienne, ktre mog zawiera HTML'owe encje.
    Rzeczy jak &amp;amp, &amp;copy i &amp;pound s przetwarzane przez
    przegldark i ich aktualna posta jest uywana dalej zamiast
    porzdanej nazwy zmiennej.  To jest oczywisty problem, o ktrym W3C
    informuje ludzi od lat. Referencje s tutaj:
    <ulink url="&url.argsep;">&url.argsep;</ulink> PHP obsuguje
    zmian separatora argumentw na zalecany przez W3C rednik
    poprzez dyrektyw arg_separator .ini.  Niestety wikszo przegldarek
    nie wysya danych z formularza w formacie uywajcym rednik jako
    separator. Bardziej przenonym rozwizaniem jest uycie &amp;amp;
    jako separatora zamiast &amp;.  Nie musisz zmienia PHP'owego
    arg_separator aby to uzyska.  Zostaw separator jako &amp;, ale
    koduj swoje URL'e uywajc
    <function>htmlentities</function>(urlencode($data)).
     <example>
      <title><function>urlencode/htmlentities</function> przykad</title>
      <programlisting role="php">
<![CDATA[
echo '<a href="mycgi?foo=', htmlentities(urlencode($userinput)), '">';
]]>
      </programlisting>
     </example>
    </para>
    <para>
     Patrz take <function>urldecode</function>,
     <function>htmlentities</function>,
     <function>rawurldecode</function>,
     <function>rawurlencode</function>.
    </para>
   </refsect1>
  </refentry>

 </reference>

<!-- 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:"../../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
-->