[PHP-DOC] cvs: phpdoc /hu/functions url.xml

[Hojtsy Gabor]

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:
-     &quot;scheme&quot; [pl. http://], &quot;host&quot;, &quot;port&quot;,
-     &quot;user&quot; [ftp url, vagy HTTP azonos�t�s eset�n],
-     &quot;pass&quot; [ftp url, vagy HTTP azonos�t�s eset�n],
-     &quot;path&quot;, &quot;query&quot; [k�rd�jel ut�ni r�sz], �s
-     &quot;fragment&quot; [?].
-    </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 &lt; 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;amp, &amp;copy �s &amp;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;amp;
+    haszn�lata az &amp; karakter helyett elv�laszt�k�nt. �gy nem kell
+    megv�ltoztatnod a PHP arg_separator be�ll�t�s�t sem. Hagyd ezt
+    &amp; �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: