leszek Fri Nov 9 19:03:13 2001 EDT
Added files:
/phpdoc/pl/functions url.xml
Log:
Finished translation
Index: phpdoc/pl/functions/url.xml
+++ phpdoc/pl/functions/url.xml
<?xml encoding="iso-8859-2"?>
<!-- $Revision: 1.1 $ -->
<reference id="ref.url">
<title>Funkcje URL</title>
<titleabbrev>URLs</titleabbrev>
<refentry id="function.base64-decode">
<refnamediv>
<refname>base64_decode</refname>
<refpurpose>Odkodowuje dane zakodowane algorytmem MIME base64</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>base64_decode</function></funcdef>
<paramdef>string <parameter>dane_zakodowane</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
<function>base64_decode</function> odkodowuje
<parameter>dane_zakodowane</parameter> i zwraca oryginalną postać
danych. Dane wynikowe mogą być binarne.
</para>
<para>
Patrz także: <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>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>base64_encode</function></funcdef>
<paramdef>string <parameter>dane</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
<function>base64_encode</function> zwraca
<parameter>dane</parameter> zakodowane za pomocą algorytmu base64.
Ten sposób kodowania został zaprojektowany, aby móc bezpiecznie
przesyłać dane binarne, poprzez warstwy transportujące nie
zaprojektowane do obsługi 8 bitowego przesyłania informacji, np.
treść email'i.
</para>
<para>
Dane zakodowane tą funkcją zajmują ok 33% więcej miejsca niż dane
oryginalne.
</para>
<para>
Patrz także:
<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>Przetważa adres URL i zwraca jego składowe</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>array <function>parse_url</function></funcdef>
<paramdef>string <parameter>url</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Funkcja ta zwraca w tablicy asocjacyjnej wszystkie składowe
przetwarzanego URL'a.
Dostępne są następujące klucze tablicy:
"scheme" (protokół), "host", "port", "user" (użytkownik), "pass" (hasło),
"path" (ścieżka), "query" (zapytanie) i "fragment" (treść kotwicy, po #).
</para>
<para>
Patrz także <function>pathinfo</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.rawurldecode">
<refnamediv>
<refname>rawurldecode</refname>
<refpurpose>Odkodowuje łańcuchy zakodowane metodą kodowania URL'i</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>rawurldecode</function></funcdef>
<paramdef>string <parameter>str</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Zwraca łańcuch w którym sekwencje dwóch cyfr szesnastkowych
poprzedzone znakiem procenta (<literal>%</literal>), zastąpione
są przez ich odpowiednik znakowy. Na przykład, łańcuch
<screen>foo%20bar%40baz</screen> zostanie odkodowany do postaci
<screen>foo bar@baz</screen>.
</para>
<simpara>
Patrz także <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>Description</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>rawurlencode</function></funcdef>
<paramdef>string <parameter>str</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Zwraca łańcuch w którym wszystkie nie alfanumeryczne znaki
z wyjątkiem <screen>-_.</screen> zostały zastąpione przez
dwie cyfry szesnastkowe poprzedzone znakiem procenta
(<literal>%</literal>). Ten sposób kodowania został opisany
w RFC1738. Zabezpiecza dane wejściowe przed zinterpretowaniem
ich jako znaki specjalne URL'a oraz zabezpiecza URL'e przed
zniekształceniem ich podczas konwersji znaków dokonywanych
przez media transmisyjne (np. niektóre systemy pocztowe).
Na przykład, jeśli chcesz dołączyć hasło do URL'a FTP:
<example>
<title><function>rawurlencode</function> przykład 1</title>
<programlisting role="php">
echo '<a href="ftp://user:', rawurlencode('foo @+%/'),
'@ftp.my.com/x.txt">';
</programlisting>
</example>
Lub, jeśli podajesz informację w części PATH_INFO (ścieżka) URL'a:
<example>
<title><function>rawurlencode</function> przykład 2</title>
<programlisting role="php">
echo '<a href="http://x.com/department_list_script/',
rawurlencode('sales and marketing/Miami'), '">';
</programlisting>
</example>
</para>
<simpara>
Patrz także <function>rawurldecode</function>,
<function>urldecode</function>,
<function>urlencode</function>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.urldecode">
<refnamediv>
<refname>urldecode</refname>
<refpurpose>Odkododwuje łańcuchy zakodowane metodą kodowania URL'i</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>urldecode</function></funcdef>
<paramdef>string <parameter>str</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Odkodowuje każdy <literal>%<replaceable>##</replaceable></literal>
kod z danego łańcucha. Odkodowany łańcuch jest zwracany.
<example>
<title><function>urldecode</function> przykład</title>
<programlisting role="php">
$a = split('&', $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>";
$i++;
}
</programlisting>
</example>
</para>
<para>
Patrz także <function>urlencode</function>,
<function>rawurlencode</function>,
<function>rawurldecode</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.urlencode">
<refnamediv>
<refname>urlencode</refname>
<refpurpose>Koduje łańcuch metodą kodowania URLi</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>urlencode</function></funcdef>
<paramdef>string <parameter>str</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Zwraca łańcuch w którym wszystkie nie alfanumeryczne znaki
z wyjątkiem <screen>-_.</screen> zostały zastąpione 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 przesyłaniu danych z formularzy WWW, tj.
takie samo jak w media typie:
<literal>application/x-www-form-urlencoded</literal>.
Różni się od kodowania z RFC1738 (zobacz
<function>rawurlencode</function>) tym, że z powodów historycznych,
spacje są kodowane jako znak plus (+). Funkcja ta jest odpowiednia
do zakodowania łańcucha używanego w zapytaniu URL oraz
jako zmienna przekazywana do następnej strony:
<example>
<title><function>urlencode</function> przykład</title>
<programlisting role="php">
echo '<a href="mycgi?foo=', urlencode($userinput), '">';
</programlisting>
</example>
</para>
<para>
Notka: Uważaj na zmienne, które mogą zawierać HTML'owe encje.
Rzeczy jak &amp, &copy i &pound są przetważane przez
przeglądarkę i ich aktualna postać jest używana dalej zamiast
porządanej nazwy zmiennej. To jest oczywisty problem, o którym W3C
informuje ludzi od lat. Referencje są tutaj:
<ulink url="&url.argsep;">&url.argsep;</ulink> PHP obsługuje
zmianę separatora argumentów na zalecany przez W3C średnik
poprzez dyrektywę arg_separator .ini. Niestety większość przeglądarek
nie wysyła danych z formularza w formacie używającym średnk jako
separator. Bardziej przenośnym rozwiązaniem jest użycie &amp;
jako separatora zamiast &. Nie musisz zmieniać PHP'owego
arg_separator aby to uzyskać. Zostaw separator jako &, ale
koduj swoje URL'e używając
<function>htmlentities</function>(urlencode($data)).
<example>
<title><function>urlencode/htmlentities</function> przykład</title>
<programlisting role="php">
echo '<a href="mycgi?foo=', htmlentities(urlencode($userinput)), '">';
</programlisting>
</example>
</para>
<para>
Patrz także <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
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
-->
