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
-->
