goba Sat Aug 18 05:54:08 2001 EDT Modified files: /phpdoc/hu/functions url.xml Log: Using PEAR standards, lowercase all tags, updating translation
Index: phpdoc/hu/functions/url.xml diff -u phpdoc/hu/functions/url.xml:1.2 phpdoc/hu/functions/url.xml:1.3 --- phpdoc/hu/functions/url.xml:1.2 Sat Jun 23 16:35:11 2001 +++ phpdoc/hu/functions/url.xml Sat Aug 18 05:54:07 2001 @@ -1,241 +1,280 @@ - <reference id="ref.url"> - <title>URL függvények</title> - <titleabbrev>URL</titleabbrev> - - <refentry id="function.base64-decode"> - <refnamediv> - <refname>base64_decode</refname> - <refpurpose>Dekódol egy MIME base64-el kódolt adatot.</refpurpose> - </refnamediv> - <refsect1> - <title>Leírás</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>base64_decode</function></funcdef> - <paramdef>string <parameter>encoded_data</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - A <function>base64_decode</function> dekódolja az - <parameter>encoded_data</parameter> paraméterben megadott adatot, - és visszaadja az eredeti adatot. A visszaadott adat lehet bináris. - </para> - <para> - Lásd még: <function>base64_encode</function>, RFC-2045 6.8. rész. - </para> - </refsect1> - </refentry> +<reference id="ref.url"> + <title>URL függvények</title> + <titleabbrev>URL</titleabbrev> - <refentry id="function.base64-encode"> - <refnamediv> - <refname>base64_encode</refname> - <refpurpose>Kódolja egy adatot MIME base64 kódolással</refpurpose> - </refnamediv> - <refsect1> - <title>Leírás</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>base64_encode</function></funcdef> - <paramdef>string <parameter>data</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - A <function>base64_encode</function> visszaadja a - <parameter>data</parameter> paraméterben megadott adatot base64 kódolással. - A kódolást úgy tervezték, hogy a bináris adatok is túléljék az olyan - közvetítő csatornákat, amik nem képesek 8 bites adattovábbításra (pl. mail üzenetek). - </para> - <para> - A base64-kódolt adat 33%-al nagyobb, mint az eredeti adat.</para> - <para> - Lásd még: - <function>base64_decode</function>, - <function>chunk_split</function>, - RFC-2045 6.8 rész. - </para> - </refsect1> - </refentry> + <refentry id="function.base64-decode"> + <refnamediv> + <refname>base64_decode</refname> + <refpurpose>MIME base64-el kódolt adatot dekódol</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>base64_decode</function> + </funcdef> + <paramdef>string <parameter>encoded_data</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>base64_decode</function> dekódolja az + <parameter>encoded_data</parameter> paraméterben megadott adatot, + és visszaadja az eredeti adatot. A visszaadott adat lehet bináris. + </para> + <para> + Lásd még: <function>base64_encode</function>, RFC-2045 6.8. rész. + </para> + </refsect1> + </refentry> - <refentry id="function.parse-url"> - <refnamediv> - <refname>parse_url</refname> - <refpurpose>Feldolgoz egy URL-t, és visszaadja a komponenseit.</refpurpose> - </refnamediv> - <refsect1> - <title>Leírás</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>parse_url</function></funcdef> - <paramdef>string <parameter>url</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Ez a függvény egy asszociatív tömböt ad vissza, ami tartalmazhatja - az alábbi elemek közül azokat, amik az URL-ben megtalálhatóak: - "scheme" [pl. http://], "host", "port", - "user" [ftp url, vagy HTTP azonosítás esetén], - "pass" [ftp url, vagy HTTP azonosítás esetén], - "path", "query" [kérdőjel utáni rész], és - "fragment" [?]. - </para> - </refsect1> - </refentry> + <refentry id="function.base64-encode"> + <refnamediv> + <refname>base64_encode</refname> + <refpurpose>Adatot kódol MIME base64 kódolással</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>base64_encode</function> + </funcdef> + <paramdef>string <parameter>data</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>base64_encode</function> visszaadja a + <parameter>data</parameter> paraméterben megadott adatot base64 kódolással. + A kódolást úgy tervezték, hogy a bináris adatok is túléljék az olyan + közvetítő csatornákat, amik nem képesek 8 bites adattovábbításra (pl. mail +üzenetek). + </para> + <para> + A base64-kódolt adat 33%-al nagyobb, mint az eredeti adat. + </para> + <para> + Lásd még: <function>base64_decode</function>, + <function>chunk_split</function>, RFC-2045 6.8 rész. + </para> + </refsect1> + </refentry> - <refentry id="function.rawurldecode"> - <refnamediv> - <refname>rawurldecode</refname> - <refpurpose>URL-kódolt string visszakódolása</refpurpose> - </refnamediv> - <refsect1> - <title>Leírás</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>rawurldecode</function></funcdef> - <paramdef>string <parameter>str</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Visszaad egy stringet, amiben százalékjelet (<literal>%</literal>) - és két hexa értéket használó kódolás szerinti szekvenciák - az eredeti karakterekkel helyettesítődnek. Például a - <screen>foo%20bar%40baz</screen> string dekódoltja <screen>foo - bar@baz</screen>. - </para> - <simpara> - Lásd még: <function>rawurlencode</function>, - <function>urldecode</function>, - <function>urlencode</function>. - </simpara> - </refsect1> - </refentry> - - <refentry id="function.rawurlencode"> - <refnamediv> - <refname>rawurlencode</refname> - <refpurpose>URL-kódolás az RFC1738 szerint</refpurpose> - </refnamediv> - <refsect1> - <title>Leírás</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>rawurlencode</function></funcdef> - <paramdef>string <parameter>str</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Visszaad egy stringet, ahol minden nem-alfanumerikus karakter, - kivéve a <screen>-_.</screen> karaktereket, egy szézalékjelre - (<literal>%</literal>) és azt követő két hexa számjegyre cserélődik. - Ez az RFC1738-ben leírt kódolás, ami feloldja a speciális karakterek - okozta problémát az URL-ekben, illetve a közvetítő média - által végrehajtott kódolás okozta hibákat kiküszöböli. Például - ha egy jelszót kell elhelyezni egy ftp url-ben: - <example> - <title>első <function>rawurlencode</function> példa</title> - <programlisting role="php"> + <refentry id="function.parse-url"> + <refnamediv> + <refname>parse_url</refname> + <refpurpose>Feldolgoz egy URL-t, és visszaadja a komponenseit</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>parse_url</function> + </funcdef> + <paramdef>string <parameter>url</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + Ez a függvény egy asszociatív tömböt ad vissza, ami tartalmazhatja + az alábbi elemek közül azokat, amik az URL-ben megtalálhatóak: + "scheme" [pl. http://], "host", "port", + "user" [FTP URL, vagy HTTP azonosítás esetén], + "pass" [FTP URL, vagy HTTP azonosítás esetén], + "path", "query" [kérdőjel utáni rész], és + "fragment" [A # utáni rész]. + </para> + </refsect1> + </refentry> + + <refentry id="function.rawurldecode"> + <refnamediv> + <refname>rawurldecode</refname> + <refpurpose>URL-kódolt karakterláncot kódol vissza</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>rawurldecode</function> + </funcdef> + <paramdef>string <parameter>str</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + Visszaad egy karakterláncot, amiben százalékjelet + (<literal>%</literal>) és két hexa értéket használó + kódolás szerinti sorozatok az eredeti karakterekkel + helyettesítődnek. Például a <screen>foo%20bar%40baz</screen> + karaktersorozat dekódoltja <screen>foo bar@baz</screen>. + </para> + <simpara> + Lásd még: <function>rawurlencode</function>, + <function>urldecode</function>, + <function>urlencode</function>. + </simpara> + </refsect1> + </refentry> + + <refentry id="function.rawurlencode"> + <refnamediv> + <refname>rawurlencode</refname> + <refpurpose>URL-kódolást végez az RFC1738 szerint</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>rawurlencode</function> + </funcdef> + <paramdef>string <parameter>str</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + Visszaad egy karakterláncot, ahol minden nem-alfanumerikus karakter, + kivéve a <screen>-_.</screen> karaktereket, egy szézalékjelre + (<literal>%</literal>) és azt követő két hexa számjegyre cserélődik. + Ez az RFC1738-ben leírt kódolás, ami feloldja a speciális karakterek + okozta problémát az URL-ekben, illetve a közvetítő média által + végrehajtott kódolás okozta hibákat kiküszöböli. Például ha egy + jelszót kell elhelyezni egy FTP URL-ben: + <example> + <title>Első <function>rawurlencode</function> példa</title> + <programlisting role="php"> <![CDATA[ -echo '<A HREF="ftp://user:', rawurlencode ('foo @+%/'), +echo '<a href="ftp://user:', rawurlencode ('foo @+%/'), '@ftp.domain.hu/titkos.txt">'; ]]> - </programlisting> - </example> - De előfordulhat, hogy az url path info komponensében kell adatot átadni: - <example> - <title>második <function>rawurlencode</function> példa</title> - <programlisting role="php"> + </programlisting> + </example> + De előfordulhat, hogy az URL PATH_INFO komponensében kell adatot átadni: + <example> + <title>Második <function>rawurlencode</function> példa</title> + <programlisting role="php"> <![CDATA[ -echo '<A HREF="http://domain.hu/kirendeltsegek_listazo/', +echo '<a href="http://domain.hu/kirendeltsegek_listazo/', rawurlencode ('kereskedelmi és marketing/Pécs'), '">'; ]]> - </programlisting> - </example> - </para> - <simpara> - Lásd még: <function>rawurldecode</function>, - <function>urlencode</function>, - <function>urldecode</function>. - </simpara> - </refsect1> - </refentry> - - <refentry id="function.urldecode"> - <refnamediv> - <refname>urldecode</refname> - <refpurpose>Dekódol egy URL-kódolt szöveget.</refpurpose> - </refnamediv> - <refsect1> - <title>Leírás</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>urldecode</function></funcdef> - <paramdef>string <parameter>str</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Dekódol bármilyen <literal>%<replaceable>##</replaceable></literal> - kódolást a megadott string-ben. A dekódolt szöveget adja vissza. - <example> - <title><function>urldecode</function> példa</title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <simpara> + Lásd még: <function>rawurldecode</function>, + <function>urlencode</function>, + <function>urldecode</function>. + </simpara> + </refsect1> + </refentry> + + <refentry id="function.urldecode"> + <refnamediv> + <refname>urldecode</refname> + <refpurpose>Dekódol egy URL-kódolt karakterláncot</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>urldecode</function> + </funcdef> + <paramdef>string <parameter>str</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + Dekódol bármilyen <literal>%<replaceable>##</replaceable></literal> + kódolást a megadott karakterláncban. A dekódolt szöveget adja vissza. + <example> + <title><function>urldecode</function> példa</title> + <programlisting role="php"> <![CDATA[ -$a = split ('&', $querystring); +$a = split('&', $querystring); $i = 0; -while ($i < count ($a)) { - $b = split ('=', $a [$i]); - echo 'A(z) ', htmlspecialchars (urldecode ($b [0])), - ' paraméter értéke ', htmlspecialchars (urldecode ($b [1])), "<BR>"; +while ($i < count($a)) { + $b = split('=', $a[$i]); + echo 'A(z) ', htmlspecialchars(urldecode($b[0])), + ' paraméter értéke ', htmlspecialchars(urldecode($b[1])), "<br>"; $i++; } ]]> - </programlisting> - </example> - </para> - <para> + </programlisting> + </example> + </para> + <para> Lásd még: <function>urlencode</function>. - </para> - </refsect1> - </refentry> + </para> + </refsect1> + </refentry> - <refentry id="function.urlencode"> - <refnamediv> - <refname>urlencode</refname> - <refpurpose>URL-kódol egy szöveget.</refpurpose> - </refnamediv> - <refsect1> - <title>Leírás</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>urlencode</function></funcdef> - <paramdef>string <parameter>str</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Visszaad egy string-et, amiben minden nem alfanumerikus karakter, kivéve a - <literal>-_.</literal> karaktereket, százalék jelre - (<literal>%</literal>) és két hexa számra cserélt, és a szóközök helyén - plusz jelek (<literal>+</literal>) vannak. Ez az a kódolási forma, - amivel a kérdőívekkel küldött adatok a Weben közlekednek, azaz az - <literal>application/x-www-form-urlencoded</literal> media típus. - Ez különbözik az RFC1738 kódolástól (<function>rawurlencode</function>) - annyiban, hogy történelmi okok miatt a szóközök itt plusz (+) jelekké - kódoltak. Ez a függvény kényelmes lehetőséget ad arra, hogy - a kérdőjel utáni részbe írjuk egy URL esetén változókat átadva a következő oldalnak: - <example> - <title><function>urlencode</function> példa</title> - <programlisting role="php"> + <refentry id="function.urlencode"> + <refnamediv> + <refname>urlencode</refname> + <refpurpose>URL-kódol egy karakterláncot</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>urlencode</function> + </funcdef> + <paramdef>string <parameter>str</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + Visszaad egy karakterláncot, amiben minden nem alfanumerikus + karakter, kivéve a <literal>-_.</literal> karaktereket, százalék jelre + (<literal>%</literal>) és két hexa számra cserélt, és a szóközök helyén + plusz jelek (<literal>+</literal>) állnak. Ez az a kódolási forma, + amivel a kérdőívekkel küldött adatok a weben közlekednek, azaz az + <literal>application/x-www-form-urlencoded</literal> média típus. + Ez annyiban különbözik az RFC1738 kódolástól (<function>rawurlencode</function>), + hogy történelmi okok miatt a szóközök itt plusz (+) jelekké alakulnak. + Ez a függvény kényelmes lehetőséget ad arra, hogy az URL kérdőjel utáni + részébe írjunk, változókat átadva a következő oldalnak: + <example> + <title><function>urlencode</function> példa</title> + <programlisting role="php"> <![CDATA[ -echo '<A HREF="ujoldal.php?ize=', urlencode ($userinput), '">'; +echo '<a href="ujoldal.php?ize=', urlencode($valtozo), '">'; +]]> + </programlisting> + </example> + </para> + <para> + Figyelem: Vigyázz az olyan változókkal, amelyek neve HTML + entitások nevével kezdődik. Az olyan karaktersorozatokat, mint + &amp, &copy és &pound a böngészők lecserélik a megfelelő + entitásra, és nem a várt eredményt kapod. Ez egy nyilvánvaló + probléma, amire a W3C már évekkel ezelőtt felhívta a figyelmet. + A referencia itt olvasható: <ulink url="&url.argsep;">&url.argsep;</ulink>. + A PHP támogatja a paraméter-elválasztó karakter megváltoztatását, + a W3C által javasolt pontosvesszőre, az arg_separator nevű .ini + beállítással. Sajnálatosan a legtöbb böngésző nem támogatja ezt + az elválasztókaraktert. Egy hordozhatóbb módszer az &amp; + használata az & karakter helyett elválasztóként. Így nem kell + megváltoztatnod a PHP arg_separator beállítását sem. Hagyd ezt + & értéken, de használd az URL kódoláshoz a + <function>htmlentities</function>(urlencode($adat)) módszert. + <example> + <title><function>urlencode/htmlentities</function> példa</title> + <programlisting role="php"> +<![CDATA[ +echo '<a href="ujoldal.php?ize=', htmlentities(urlencode($valtozo)), '">'; ]]> </programlisting> - </example> - </para> - <para> - Lásd még: <function>urldecode</function>. - </para> - </refsect1> - </refentry> - - </reference> + </example> + </para> + <para> + Lásd még: <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: