gerzson Tue Feb 19 04:36:23 2002 EDT
Modified files:
/phpdoc/hu/functions url.xml exec.xml mail.xml
Log:
sync with EN revision
Index: phpdoc/hu/functions/url.xml
diff -u phpdoc/hu/functions/url.xml:1.7 phpdoc/hu/functions/url.xml:1.8
--- phpdoc/hu/functions/url.xml:1.7 Sat Feb 2 10:41:26 2002
+++ phpdoc/hu/functions/url.xml Tue Feb 19 04:36:22 2002
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-2"?>
-<!-- EN-Revision: 1.15 Maintainer: goba Status: ready -->
+<!-- EN-Revision: 1.27 Maintainer: goba Status: ready -->
<reference id="ref.url">
<title>URL f�ggv�nyek</title>
@@ -40,12 +40,13 @@
</methodsynopsis>
<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).
+ <parameter>data</parameter> param�terben megadott adat base64 k�dolt
+ alakj�t. A k�dol�st �gy tervezt�k, hogy a bin�ris adatok is t�l�lj�k
+ az olyan k�zvet�t� csatorn�kat, amelyek 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.
+ A base64-k�dolt adat megk�zel�t�leg 33%-kal nagyobb az eredeti m�ret�n�l.
</para>
<para>
L�sd m�g: <function>base64_decode</function>,
@@ -66,13 +67,54 @@
<methodparam><type>string</type><parameter>url</parameter></methodparam>
</methodsynopsis>
<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].
+ Ez a f�ggv�ny olyan asszociat�v t�mb�t ad vissza, amely tartalmazza az
+ al�bbi elemek k�z�l azokat, amelyek az <parameter>url</parameter>
+ r�szei:
+ <itemizedlist>
+ <listitem>
+ <simpara>
+ <structfield>scheme</structfield> - pl.: http://
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <structfield>host</structfield>
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <structfield>port</structfield>
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <structfield>user</structfield>
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <structfield>pass</structfield>
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <structfield>path</structfield>
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <structfield>query</structfield> - <literal>?</literal> ut�ni r�sz
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <structfield>fragment</structfield> - <literal>#</literal> ut�ni r�sz
+ </simpara>
+ </listitem>
+ </itemizedlist>
+ </para>
+ <para>
+ L�sd m�g: <function>pathinfo</function>!
</para>
</refsect1>
</refentry>
@@ -89,16 +131,22 @@
<methodparam><type>string</type><parameter>str</parameter></methodparam>
</methodsynopsis>
<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>
+ A <parameter>str</parameter>-ben megadott sztringet visszak�dolja �gy, hogy
+ minden sz�zal�kjelet (<literal>%</literal>) �s ut�na �ll� k�t hexadecim�lis
+ sz�mjegyet a megjel�lt sorsz�m� karakterrel cser�l fel. P�ld�ul
+ a <screen>foo%20bar%40baz</screen>
+ karaktersorozatb�l <screen>foo bar@baz</screen> lesz.
+ </para>
+ <note>
+ <para>
+ <function>rawurldecode</function> nem cser�li le a plusz jelet ('+')
+ sz�k�zz�, amint azt az <function>urldecode</function> teszi.
+ </para>
+ </note>
<simpara>
L�sd m�g: <function>rawurlencode</function>,
- <function>urldecode</function>,
- <function>urlencode</function>.
+ <function>urldecode</function> �s
+ <function>urlencode</function>!
</simpara>
</refsect1>
</refentry>
@@ -115,13 +163,14 @@
<methodparam><type>string</type><parameter>str</parameter></methodparam>
</methodsynopsis>
<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:
+ Olyan stringgel t�r vissza, amelyben az <parameter>str</parameter> nem
+ alfanumerikus karakterei - kiv�ve a <screen>-_.</screen> karaktereket -
+ egy sz�zal�kjelre (<literal>%</literal>) �s azt k�vet� k�t hexadecim�lis
+ sz�mjegyre lesz lecser�lve. Ez az RFC1738-ben le�rt k�dol�snak megfelel�,
+ amely feloldja a speci�lis karakterek az URL-ekben t�rt�n� haszn�lat�t
+ nehez�t� probl�m�t, illetve a k�zvet�t� m�dia �ltal v�grehajtott k�dol�s
+ okozta hib�kat kik�sz�b�li. Ha egy jelsz�t kell p�ld�ul elhelyezni egy FTP
+ URL-ben:
<example>
<title>Els� <function>rawurlencode</function> p�lda</title>
<programlisting role="php">
@@ -131,7 +180,8 @@
]]>
</programlisting>
</example>
- De el�fordulhat, hogy az URL PATH_INFO komponens�ben kell adatot �tadni:
+ El�fordulhat azonban, hogy az URL PATH_INFO komponens�ben kell adatot
+ �tadni:
<example>
<title>M�sodik <function>rawurlencode</function> p�lda</title>
<programlisting role="php">
@@ -144,8 +194,8 @@
</para>
<simpara>
L�sd m�g: <function>rawurldecode</function>,
- <function>urlencode</function>,
- <function>urldecode</function>.
+ <function>urlencode</function> �s
+ <function>urldecode</function>!
</simpara>
</refsect1>
</refentry>
@@ -181,7 +231,7 @@
</example>
</para>
<para>
- L�sd m�g: <function>urlencode</function>.
+ L�sd m�g: <function>urlencode</function>!
</para>
</refsect1>
</refentry>
@@ -244,8 +294,8 @@
<para>
L�sd m�g: <function>urldecode</function>,
<function>htmlentities</function>,
- <function>rawurldecode</function>,
- <function>rawurlencode</function>.
+ <function>rawurldecode</function> �s
+ <function>rawurlencode</function>!
</para>
</refsect1>
</refentry>
@@ -267,5 +317,7 @@
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
-->
-
Index: phpdoc/hu/functions/exec.xml
diff -u phpdoc/hu/functions/exec.xml:1.8 phpdoc/hu/functions/exec.xml:1.9
--- phpdoc/hu/functions/exec.xml:1.8 Sat Feb 2 10:41:24 2002
+++ phpdoc/hu/functions/exec.xml Tue Feb 19 04:36:22 2002
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-2"?>
-<!-- EN-Revision: 1.17 Maintainer: goba Status: ready -->
+<!-- EN-Revision: 1.27 Maintainer: goba Status: ready -->
<reference id="ref.exec">
<title>Programfuttat� f�ggv�nyek</title>
@@ -27,26 +27,29 @@
<methodparam><type>string</type><parameter>arg</parameter></methodparam>
</methodsynopsis>
<para>
- Az <function>escapeshellarg</function> aposztr�fokat tesz a param�terben
- �tadott karakterl�nc k�r� �s escape-eli a karakterl�ncban l�v� aposztr�fokat,
- �gy egy shell f�ggv�ny �n�ll� param�terek�nt haszn�lhat� karaktersorozatot ad
- vissza. Ez a f�ggv�ny haszn�latos a felhaszn�l�t�l �rkez� egyedi shell f�ggv�ny
- param�terek biztons�goss� alak�t�s�ra. Shell f�ggv�nyek az
- <function>exec</function>, <function>system</function> �s a
- <link linkend="language.operators.execution">v�grehajt� oper�tor</link>.
- Egy tipikus haszn�lat:
+ Az <function>escapeshellarg</function> aposztr�fok k�z� fogja az
+ <parameter>arg</parameter> param�terben �tadott sz�veget �s megkett�zi a
+ benne l�v� aposztr�fokat, �gy egy parancs�rtelmez� f�ggv�nyek �n�ll�
+ param�terek�nt haszn�lhat� karaktersorozatot ad vissza. Ez a f�ggv�ny
+ haszn�latos a felhaszn�l�t�l �rkez� egyedi parancs�rtelmez� f�ggv�nyek
+ param�tereinek biztons�goss� alak�t�s�ra. Ezek a f�gv�nyek : az
+ <function>exec</function>, a <function>system</function> �s a <link
+ linkend="language.operators.execution">v�grehajt� oper�tor</link>.
+ Jellemz� haszn�lata:
</para>
<para>
<informalexample>
<programlisting role="php">
+<![CDATA[
system("ls ".escapeshellarg($dir));
+]]>
</programlisting>
</informalexample>
</para>
<para>
L�sd m�g: <function>exec</function>, <function>popen</function>,
- <function>system</function>, �s a <link
- linkend="language.operators.execution">v�grehajt� oper�tor</link>.
+ <function>system</function> �s a <link
+ linkend="language.operators.execution">v�grehajt� oper�tor</link>!
</para>
</refsect1>
</refentry>
@@ -65,11 +68,10 @@
<para>
Az <function>escapeshellcmd</function> escape-et alkalmaz minden
speci�lis karakterre, ami nem k�v�nt parancsok futtat�s�t okozn�.
- Ezt a f�ggv�ny arra haszn�lhatod, hogy a felhaszn�l�kt�l
- �rkez� inform�ci�t biztons�goss� tedd, miel�tt egy
- <function>exec</function> vagy <function>system</function>
+ Ez a f�ggv�ny arra haszn�lhat�, hogy biztos�tsd a felhaszn�l�t�l �rkez� adat
+ tisztas�g�t egy <function>exec</function> vagy egy <function>system</function>
f�gg�nyh�v�sn�l, vagy egy <link linkend="language.operators.execution">v�grehajt�
- oper�torban</link> haszn�ln�d. Egy tipikus haszn�lati forma:
+ oper�torban</link> haszn�ln�d. �ltal�nos haszn�lati forma:
</para>
<para>
<informalexample>
@@ -86,7 +88,7 @@
<para>
L�sd m�g: <function>escapeshellarg</function>, <function>exec</function>,
<function>popen</function>, <function>system</function>
- �s a <link linkend="language.operators.execution">v�grehajt� oper�tor</link>.
+ �s a <link linkend="language.operators.execution">v�grehajt� oper�tor</link>!
</para>
</refsect1>
</refentry>
@@ -105,47 +107,46 @@
<methodparam
choice="opt"><type>int</type><parameter>return_var</parameter></methodparam>
</methodsynopsis>
<para>
- Az <function>exec</function> lefuttatja a megadott
- <parameter>command</parameter> parancsot, hab�r nem �r ki semmit,
- csak egyszer�en visszaadja a legutols� sort, amit a parancs
- gener�lt. Ha �gy szeretn�l futtatni egy parancsot, hogy az
- minden adatfeldolgoz�s n�lk�l ki�r�sa ker�lj�n, haszn�ld
- a <function>passthru</function> f�ggv�nyt.
- </para>
- <para>
- Ha az <parameter>array</parameter> param�tert megadtad,
- a kimenetet soronk�nt a t�mb v�g�re f�zi a PHP.
- Ha egy m�r l�tez� t�mb�t adsz meg, az
- <function>exec</function> a benne l�v� adatok ut�n f�zi a sorokat.
- Ha nem szeretn�d, hogy megmaradjon a t�mb el�z� tartalma, haszn�ld az
- <function>unset</function> f�ggv�nyt, miel�tt megh�vod az
- <function>exec</function>-et.
- </para>
- <para>
- Ha a <parameter>return_var</parameter> param�ter defini�lt,
- az <parameter>array</parameter> param�terrel egy�tt, akkor
- a parancs visszat�r�s-ideji �llapota ebbe a v�ltoz�ba ker�l.
- </para>
- <para>
- Ha egy felhaszn�l� �ltal beadott adatot szeretn�l �tadni
- ennek a f�ggv�nynek, haszn�ld az
- <function>escapeshellcmd</function> f�ggv�nyt, hogy biztos
- lehess benne, hogy nem tudnak a felhaszn�l�k tetsz�leges
- parancsot futtatni.
- </para>
- <para>
- Ha ezzel a f�ggv�nnyel el szeretn�l ind�tani egy programot,
- amit ut�na a h�tt�rben futni hagsz, meg kell r�la gy�z�dn�d,
- hogy a program kimenete egy file-ba ker�l �tir�ny�t�sra,
- vagy valamilyen m�s kimeneti csatorn�ra. Ellenkez� esetben
- a PHP v�rakozni fog addig, am�g a program fut�sa be nem
- fejez�d�tt.
- </para>
+ Az <function>exec</function> lefuttatja a
+ <parameter>command</parameter>-ban megadott parancsot, amely �gy nem �r ki
+ semmit, csak egyszer�en visszaadja a legutols� sort, amit a parancs
+ gener�lt. A <function>passthru</function> f�ggv�ny haszn�lhat� arra, hogy
+ a parancs eredm�nye minden adatfeldolgoz�s n�lk�l ki�r�sa ker�lj�n.
+ </para>
+ <para>
+ Az <parameter>array</parameter> param�ter megad�s�val a program kimenet�t
+ a PHP soronk�nt a megadott t�mb v�g�hez f�zi. Ha az �tadott t�mb m�r
+ tartalmaz n�h�ny elemet, akkor az <function>exec</function> a benne l�v�
+ adatok ut�n f�zi a sorokat. Ha nincs sz�ks�g a r�gi elemekre, akkor az
+ <function>unset</function> f�ggv�nnyel lehet t�r�lni az eg�sz t�mb�t,
+ az <function>exec</function> megh�v�sa el�tt.
+ </para>
+ <para>
+ Az <parameter>array</parameter> param�terrel egy�tt a
+ <parameter>return_var</parameter> a futtatott parancs visszat�r�si
+ �llapot�t t�rolja el.
+ </para>
+ <warning>
+ <para>
+ Ha felhaszn�l�t�l sz�rmaz� adatot kell �tadni ennek a f�ggv�nynek, akkor
+ el�tte haszn�ld az <function>escapeshellcmd</function> f�ggv�nyt, annak
+ biztos�t�s�ra, hogy nem tudnak a felhaszn�l�k tetsz�leges parancsot
+ futtatni.
+ </para>
+ </warning>
+ <note>
+ <para>
+ Ezzel a f�ggv�nnyel elind�tott de h�tt�rben fut� program kimenet�t
+ mindenk�ppen f�jlba vagy valamilyen m�s kimeneti csatorn�ba kell
+ �tir�ny�tani. Ellenkez� esetben a PHP v�rakozni fog addig, am�g a
+ program fut�sa be nem fejez�dik.
+ </para>
+ </note>
<para>
L�sd m�g: <function>system</function>,
<function>passthru</function>, <function>popen</function>,
<function>escapeshellcmd</function> �s a
- <link linkend="language.operators.execution">v�grehajt� oper�tor</link>.
+ <link linkend="language.operators.execution">v�grehajt� oper�tor</link>!
</para>
</refsect1>
</refentry>
@@ -166,33 +167,38 @@
</methodsynopsis>
<para>
A <function>passthru</function> f�ggv�ny hasonl� az
- <function>exec</function>-hez, ugyanis a
- <parameter>command</parameter> param�terben megadott parancsot
- futtatja. Ha a <parameter>return_var</parameter> param�ter
- adott, akkor a parancs visszat�r�s-ideji �llapota
- ebbe a v�ltoz�ba ker�l. Ezt a f�ggv�nyt haszn�ld az
- <function>exec</function> vagy <function>system</function>
- helyett, ha a parancs kimenete bin�ris adat, amit k�zvetlen�l
- a b�ng�sz�nek kell visszak�ldeni. Tipikusan p�ld�ul
- a pbmplus eszk�z�k futtat�s�ra haszn�lhat�, amik k�pesek
- k�zvetlen�l k�p visszaad�s�ra. Ha a Content-type fejl�cet
- <emphasis>image/gif</emphasis>-re �ll�tod, �s megh�vod
- a pbmplus programot, ami visszaad egy k�pet, k�sz�thetsz
- olyan PHP programot, ami k�zevteln�l k�pet ad vissza.
- </para>
- <para>
- Ha ezzel a f�ggv�nnyel el szeretn�l ind�tani egy programot,
- amit ut�na a h�tt�rben futni hagsz, meg kell r�la gy�z�dn�d,
- hogy a program kimenete egy file-ba ker�l �tir�ny�t�sra,
- vagy valamilyen m�s kimeneti csatorn�ra. Ellenkez� esetben
- a PHP v�rakozni fog addig, am�g a program fut�sa be nem
- fejez�d�tt.
- </para>
+ <function>exec</function>-hez, ugyanis a <parameter>command</parameter>
+ param�terben megadott parancsot futtatja. A <parameter>return_var</parameter>
+ param�terben a parancs visszat�r�si �llapota ker�l. Ez a f�ggv�ny
+ haszn�lhat� az <function>exec</function> vagy a <function>system</function>
+ helyett, ha a parancs kimenete bin�ris adat, amit k�zvetlen�l a b�ng�sz�nek
+ kell visszak�ldeni. Tipikusan p�ld�ul a pbmplus eszk�z�k futtat�s�ra
+ haszn�lhat�, amelyek k�pesek k�zvetlen�l k�p visszaad�s�ra. A
+ <literal>Content-type</literal> fejl�cet <emphasis>image/gif</emphasis>-re
+ �ll�tva �s a pbmplus programot megh�vva, az visszaad egy k�pet, �s �gy olyan
+ PHP programot �rhat�k, amelyek k�zvetlen�l k�peket adnak vissza.
+ </para>
+ <warning>
+ <para>
+ Ha felhaszn�l�t�l sz�rmaz� adatot kell �tadni ennek a f�ggv�nynek, akkor
+ el�tte haszn�ld az <function>escapeshellcmd</function> f�ggv�nyt, annak
+ biztos�t�s�ra, hogy nem tudnak a felhaszn�l�k tetsz�leges parancsot
+ futtatni.
+ </para>
+ </warning>
+ <note>
+ <para>
+ Ezzel a f�ggv�nnyel elind�tott de h�tt�rben fut� program kimenet�t
+ mindenk�ppen f�jlba vagy valamilyen m�s kimeneti csatorn�ba kell
+ �tir�ny�tani. Ellenkez� esetben a PHP v�rakozni fog addig, am�g a
+ program fut�sa be nem fejez�dik.
+ </para>
+ </note>
<para>
L�sd m�g: <function>exec</function>, <function>system</function>,
- <function>popen</function>, <function>escapeshellcmd</function>,
+ <function>popen</function>, <function>escapeshellcmd</function>
�s a <link linkend="language.operators.execution">v�grehajt�
- oper�tor</link>.
+ oper�tor</link>!
</para>
</refsect1>
</refentry>
@@ -206,36 +212,37 @@
</refnamediv>
<refsect1>
<title>Le�r�s</title>
- <methodsynopsis>
- <type>string</type><methodname>system</methodname>
- <methodparam><type>string</type><parameter>command</parameter></methodparam>
- <methodparam
choice="opt"><type>int</type><parameter>return_var</parameter></methodparam>
- </methodsynopsis>
+ <methodsynopsis>
+ <type>string</type><methodname>system</methodname>
+ <methodparam><type>string</type><parameter>command</parameter></methodparam>
+ <methodparam
+choice="opt"><type>int</type><parameter>return_var</parameter></methodparam>
+ </methodsynopsis>
<para>
A <function>system</function> f�ggv�ny olyan, mint
- C-beli testv�re, azaz a <parameter>command</parameter>
+ C-beli t�rsa, azaz a <parameter>command</parameter>
param�terben megadott parancsot futtaja, �s ki�rja a kimenetet.
- Ha m�sodik param�terk�nt megadsz egy v�ltoz�t, a visszat�r�s-ideji
- �llapot abba a v�ltoz�ba ker�l.
- </para>
- <para>
- Ha egy felhaszn�l� �ltal beadott adatot szeretn�l �tadni
- ennek a f�ggv�nynek, haszn�ld az
- <function>escapeshellcmd</function> f�ggv�nyt, hogy biztos
- lehess benne, hogy nem tudnak a felhaszn�l�k tetsz�leges
- parancsot futtatni.
- </para>
- <para>
- Ha ezzel a f�ggv�nnyel el szeretn�l ind�tani egy programot,
- amit ut�na a h�tt�rben futni hagsz, meg kell r�la gy�z�dn�d,
- hogy a program kimenete egy file-ba ker�l �tir�ny�t�sra,
- vagy valamilyen m�s kimeneti csatorn�ra. Ellenkez� esetben
- a PHP v�rakozni fog addig, am�g a program fut�sa be nem
- fejez�d�tt.
+ A <parameter>return_var</parameter> param�terben a parancs visszat�r�si
+ �llapota ker�lhet, ha szerepel.
</para>
+ <warning>
+ <para>
+ Ha felhaszn�l�t�l sz�rmaz� adatot kell �tadni ennek a f�ggv�nynek, akkor
+ el�tte haszn�ld az <function>escapeshellcmd</function> f�ggv�nyt, annak
+ biztos�t�s�ra, hogy nem tudnak a felhaszn�l�k tetsz�leges parancsot
+ futtatni.
+ </para>
+ </warning>
+ <note>
+ <para>
+ Ezzel a f�ggv�nnyel elind�tott de h�tt�rben fut� program kimenet�t
+ mindenk�ppen f�jlba vagy valamilyen m�s kimeneti csatorn�ba kell
+ �tir�ny�tani. Ellenkez� esetben a PHP v�rakozni fog addig, am�g a
+ program fut�sa be nem fejez�dik.
+ </para>
+ </note>
<para>
A <function>system</function> f�ggv�ny automatikusan �r�teni
- pr�b�lja a szerver kimeneti buffer�t minden kiadott sor ut�n,
+ pr�b�lja a szerver kimeneti puffer�t minden kiadott sor ut�n,
ha a PHP szerver modulk�nt fut.
</para>
<para>
@@ -243,18 +250,38 @@
vagy &false; �rt�ket ha hiba t�rt�nik.
</para>
<para>
- Ha le kell futtatnod egy parancsot, �s ki kell adnod minden
- kimenet�t feldolgoz�s n�lk�l, haszn�ld az
- <function>passthru</function> f�ggv�nyt.
+ A <function>passthru</function> f�ggv�ny haszn�lhat� arra, hogy a
+ parancs eredm�nye minden adatfeldolgoz�s n�lk�l ki�r�sa ker�lj�n.
</para>
<para>
L�sd m�g: <function>exec</function>,
<function>passthru</function>, <function>popen</function>,
<function>escapeshellcmd</function> �s a
- <link linkend="language.operators.execution">v�grehajt� oper�tor</link>.
+ <link linkend="language.operators.execution">v�grehajt� oper�tor</link>!
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id='function.shell-exec'>
+ <refnamediv>
+ <refname>shell_exec</refname>
+ <refpurpose>
+ lefuttat parancs�rtelmez�ben egy parancsot �s a teljes kimenetet visszaadja
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Le�r�s</title>
+ <methodsynopsis>
+ <type>string</type><methodname>shell_exec</methodname>
+ <methodparam><type>string</type><parameter>cmd</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Ez a f�ggv�ny azonos a <link
+ linkend="language.operators.execution">v�grehajt� oper�torral</link>.
</para>
</refsect1>
</refentry>
+
</reference>
<!-- Keep this comment at the end of the file
@@ -273,5 +300,7 @@
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
-->
-
Index: phpdoc/hu/functions/mail.xml
diff -u phpdoc/hu/functions/mail.xml:1.7 phpdoc/hu/functions/mail.xml:1.8
--- phpdoc/hu/functions/mail.xml:1.7 Sat Feb 2 10:41:25 2002
+++ phpdoc/hu/functions/mail.xml Tue Feb 19 04:36:23 2002
@@ -1,12 +1,66 @@
<?xml version="1.0" encoding="iso-8859-2"?>
-<!-- EN-Revision: 1.9 Maintainer: goba Status: ready -->
+<!-- EN-Revision: 1.37 Maintainer: goba Status: ready -->
+<!-- CREDITS: gerzson -->
<reference id="ref.mail">
<title>Mail f�ggv�nyek</title>
<titleabbrev>Mail</titleabbrev>
<partintro>
- <simpara>
- A <function>mail</function> f�ggv�ny ad lehet�s�get email k�ld�s�re.</simpara>
+ <simpara>
+ A <function>mail</function> f�ggv�ny ad lehet�s�get email k�ld�s�re.
+ </simpara>
+ <variablelist>
+ <title>Levelez�s be�ll�t�si lehet�s�gei</title>
+
+ <varlistentry id="ini.smtp">
+ <term>
+ <parameter>SMTP</parameter>
+ <type>string</type>
+ </term>
+ <listitem>
+ <para>
+ A DNS neve vagy IP c�me annak az SMTP szervernek, amit a PHP Windows alatt
+ a mail k�ld�sre haszn�l, amikor a <function>mail</function>
+ f�ggv�nyt h�vod meg.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="ini.sendmail-from">
+ <term>
+ <parameter>sendmail_from</parameter>
+ <type>string</type>
+ </term>
+ <listitem>
+ <para>
+ Megadja, hogy milyen "From:" email c�met haszn�ljon
+ a PHP mail k�ld�sekor Windows alatt.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="ini.sendmail-path">
+ <term>
+ <parameter>sendmail_path</parameter>
+ <type>string</type>
+ </term>
+ <listitem>
+ <para>
+ Megadja, hogy hol tal�lhat� a <command>sendmail</command> program.
+ Ez �ltal�ban <filename>/usr/sbin/sendmail</filename> vagy
+ <filename>/usr/lib/sendmail</filename>.
+ A <command>configure</command> megpr�b�lja megtal�lni, �s
+ be�ll�tani, de ha ez nem siker�l, itt te is be�ll�thatod.
+ </para>
+ <para>
+ Azokon a rendszereken, ahol nem a sendmail haszn�latos, ez a be�ll�t�s a
+ sendmail wrapper/helyettes�t� be�ll�t�s�ra szolg�l, ha van ilyen.
+ P�ld�ul a <ulink url="&url.qmail;">Qmail</ulink>
+ haszn�l�k �ltal�ban a
+ <filename>/var/qmail/bin/sendmail</filename> be�ll�t�st haszn�lj�k.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
</partintro>
@@ -25,83 +79,151 @@
<methodparam choice="opt"><type>string</type><parameter>additional_headers
</parameter></methodparam>
</methodsynopsis>
- <simpara>
+ <simpara>
A <function>mail</function> automatikusan a
<parameter>message</parameter> param�terben megadott levelet
a <parameter>to</parameter> param�terben megadott c�mzettnek.
A lev�l t�mamegjel�l�s�t a <parameter>subject</parameter>
hat�rozza meg. T�bb c�mzettet is megadhatsz, ha vessz�t
teszel a c�mzettek list�j�ban az email c�mek k�z�
- a <parameter>to</parameter> param�ter�ben.
+ a <parameter>to</parameter> param�ter�ben. Lev�lmell�kletek �s egy�b
+ k�l�nleges tartalm� levelek k�ld�s�re is haszn�lhat� ez a f�ggv�ny.
+ Ezeket a MIME k�dol�ssal �rhet�k el, amelyr�l r�szletesebb le�r�st
+ egy <ulink url="&url.email.mime.zend;">Zend cikkben</ulink> vagy
+ a <ulink url="&url.email.mime.pear;">PEAR Mime Classes</ulink> c.
+ tal�lhat�.
+ </simpara>
+ <simpara>
+ A k�vetke� RFC-k is sz�mos seg�ts�get ny�jthatnak:
+ <ulink url="&url.rfc1896;">RFC 1896</ulink>,
+ <ulink url="&url.rfc2045;">RFC 2045</ulink>,
+ <ulink url="&url.rfc2046;">RFC 2046</ulink>,
+ <ulink url="&url.rfc2047;">RFC 2047</ulink>,
+ <ulink url="&url.rfc2048;">RFC 2048</ulink> �s
+ <ulink url="&url.rfc2049;">RFC 2049</ulink>.
+ </simpara>
+ <para>
+ A <function>mail</function> &true;-val t�r vissza, ha levelet sikeresen
+ elk�ldte m�sk�l�nben &false;-szal.
+ </para>
+ <para>
+ <example>
+ <title>Email k�ld�se</title>
+ <programlisting>
+<![CDATA[
+mail("[EMAIL PROTECTED]", "T�mamegjel�l�s", "Els� sor\nM�sodik sor\nHarmadik sor");
+]]>
+ </programlisting>
+ </example></para>
+ <simpara>
+ A negyedik param�ter megadott sz�veg az email fejl�c v�g�re
+ ker�l. Ez nagyon gyakran �jabb fejl�cek elk�ld�s�re haszn�lhat�,
+ t�bb ilyen eset�n azokat az �jsorkarakterrel kell elv�lasztani.
</simpara>
+ <note>
+ <para>
+ A fejl�cek elv�laszt�s�ra a <literal>\r\n</literal> karaktersorozatot kell
+ haszn�lni m�g akkor is, ha n�h�ny Unix lev�ltov�bb�t� elem az egyszer�
+ �jsorkarakterrel (<literal>\n</literal>) is be�ri. A Cc:
+ fejl�c kis- �s nagy bet�re �rz�keny, �gy <literal>Cc:</literal> kell �rni
+ Win32 rendszereken. A Bcc: fejl�cet nem t�mogatj�k a Win32 rendszerek.
+ </para>
+ </note>
<para>
<example>
- <title>Email k�ld�se</title>
+ <title>e-mail k�ld�se kieg�sz�t� fejl�cekkel</title>
<programlisting>
<![CDATA[
-mail("[EMAIL PROTECTED]", "T�mamegjel�l�s", "Els� sor\nM�sodik sor\nHarmadik sor");
+mail("[EMAIL PROTECTED]", "T�ma", $uzenet,
+ "From: webmaster@$SERVER_NAME\r\n".
+ "Reply-To: webmaster@$SERVER_NAME\r\n".
+ "X-Mailer: PHP/" . phpversion());
]]>
</programlisting>
- </example></para>
- <simpara>
- Ha a negyedik param�tert is megadod, az az email fejl�c v�g�re
- ker�l. Ez tipikusan plusz fejl�cek elk�ld�s�re haszn�lhat�.
- T�bb plusz fejl�cet az �jsor karakterrel kell elv�lasztani.
- </simpara>
+ </example>
+ </para>
<para>
+ Az <parameter>additional_parameters</parameter> param�ter haszn�lhat�
+ arra, hogy a lev�lk�ld�k�nt be�ll�tott program sz�m�ra tov�bbi
+ param�tereket lehessen �tadni, l�sd: <literal>sendmail_path</literal>).
+ Ezzel p�ld�ul a lev�l mell� a felad� 'bor�t�kot' is k�ldhet a sendmail-t
+ haszn�lva. Sz�ks�g lehet a webszervert futtat� felhaszn�l�t sendmail
+ be�ll�t�sai k�z� felvenni, hogy a levelekbe ne ker�ljenek
+ <literal>X-Warning</literal> fejl�cek, ha ezzel a m�dszerrel k�ldesz
+ 'bor�t�kot' a lev�l mell�.
<example>
- <title>Email k�ld�se plusz fejl�cekkel</title>
+ <title>Kieg�sz�t� fejl�ces lev�l k�ld�se �s tov�bbi parancssori param�terek
+�tad�sa</title>
<programlisting>
<![CDATA[
-mail("[EMAIL PROTECTED]", "T�ma", $uzenet,
- "From: webmaster@$SERVER_NAME\nReply-To: webmaster@$SERVER_NAME\nX-Mailer: PHP/"
. phpversion());
+mail("[EMAIL PROTECTED]", "a t�rgy", $uzenet,
+ "From: webmaster@$SERVER_NAME", "-fwebmaster@$SERVER_NAME");
]]>
</programlisting>
</example>
- Egyszer� string technik�kat alkalmazhatsz komplex email
+ </para>
+ <note>
+ <para>
+ Az �t�dik param�ter PHP 4.0.5-t�l el�rhet�.
+ </para>
+ </note>
+ <para>
+ Egyszer� sztring kezel� m�dszerekkel lehet �sszetettebb e-mail
�zenetek �ssze�ll�t�s�hoz:
<example>
<title>Komplexebb email k�ld�se</title>
<programlisting>
<![CDATA[
-/* C�mzettek */
-$cimzett .= "Mary <[EMAIL PROTECTED]>" . ", " ; // Figyeld a vessz�t
-$cimzett .= "Kelly <[EMAIL PROTECTED]> . ", ";
-$cimzett .= "[EMAIL PROTECTED]";
-
-/* T�ma */
-$tema = "Augusztusi sz�let�snapi eml�keztet�k";
-
-/* �zenet */
-$uzenet .= "Egy sz�p form�zott ASCII t�bl�zat k�vetkezik\n";
-$uzenet .= "Nap \t\tH�nap \t\t�v\n";
-$uzenet .= "3. \t\tAug \t\t1970\n";
-$uzenet .= "17. \t\tAug \t\t1973\n";
-
-/* Szokv�nyos al��r�st is adhatsz a lev�lhez */
-$uzenet .= "--\r\n"; // Al��r�st elv�laszt� karakterek
-$uzenet .= "A sz�let�snapi figyelmeztet� szkript szabadon m�solhat�";
-
-/* Minden tov�bbi fejl�c �ssze�ll�t�sa */
-
-$fejlecek .= "From: Szuletesnapi ertesito <[EMAIL PROTECTED]>\n";
-$fejlecek .= "X-Sender: <[EMAIL PROTECTED]>\n";
-$fejlecek .= "X-Mailer: PHP\n"; // Levelez�program
-$fejlecek .= "X-Priority: 1\n"; // S�rg�s �zenet!
-$fejlecek .= "Return-Path: <[EMAIL PROTECTED]>\n"; // Hiba eset�n ide j�n lev�l
+/* c�mzettek */
+$kinek = "Mari <[EMAIL PROTECTED]>" . ", " ; // figyelj a vessz�re!
+$kinek .= "Kolos <[EMAIL PROTECTED]>";
+
+/* t�rgy */
+$targy = "Augusztusi Sz�let�snapi Eml�keztet�";
+
+/* �zenet */
+$uzenet = '
+<html>
+<head>
+ <title>Augusztusi Sz�let�snapi Eml�keztet�</title>
+</head>
+<body>
+<p>Itt van az augusztusi sz�let�snapok list�ja!</p>
+<table>
+ <tr>
+ <th>Szem�ly</th><th>�v</th><th>H�nap</th><th>Nap</th>
+ </tr>
+ <tr>
+ <td>Joc�</td><td>1970</td><td>augusztus</td><td>3.</td>
+ <td>Saci</td><td>1973</td><td>augusztus</td><td>17.</td>
+ </tr>
+</table>
+</body>
+</html>
+';
+
+/* HTML lev�l k�ld�se a Content-type fejl�c megad�s�val */
+$fejlec = "MIME-Version: 1.0\r\n";
+$fejlec .= "Content-type: text/html; charset=iso-8859-2\r\n";
-/* Ha HTML levelet szeretn�l k�ldeni, vedd ki a megjegyz�st */
-// $fejlecek .= "Content-Type: text/html; charset=iso-8859-1\n"; // Mime t�pus
+/* tov�bbi fejl�cek */
+$fejlec .= "From: Szuletesnapi Emlekezteto <[EMAIL PROTECTED]>\r\n";
-$fejlecek .= "cc:[EMAIL PROTECTED]\n"; // CC c�mzett
-$fejlecek .= "bcc:[EMAIL PROTECTED], [EMAIL PROTECTED]\n"; // BCCs c�mzett
+$fejlec .= "Cc: [EMAIL PROTECTED]\r\n";
+$fejlec .= "Bcc: [EMAIL PROTECTED]\r\n";
-/* �s most elk�dj�k TADA! [.wav] */
-mail($cimzett, $tema, $uzenet, $fejlecek);
+/* �s most k�ldj�k el! */
+mail($kinek, $targy, $uzenet, $fejlec);
]]>
</programlisting>
</example>
</para>
+ <note>
+ <para>
+ Biztos�tani kell, hogy a ne legyen egyetlen �jsorkarakter sem a
+ <parameter>to</parameter> vagy a <parameter>subject</parameter>
+ fejl�cben, mert k�l�nben nem megfelel�en lesz kik�ldve a lev�l.
+ </para>
+ </note>
</refsect1>
</refentry>
@@ -126,7 +248,7 @@
<title>A hash kisz�m�t�sa �s a felhaszn�l� fel�r�sa a list�ra</title>
<programlisting>
<![CDATA[
-$felhasznalo = "[EMAIL PROTECTED]";
+$felhasznalo = "[EMAIL PROTECTED]";
$hash = ezmlm_hash ($felhasznalo);
$query = sprintf ("INSERT INTO minta VALUES (%s, '%s')", $hash, $felhasznalo);
$db->query($query); // itt �ppen a PHPLIB db fel�letet haszn�ljuk
@@ -139,7 +261,7 @@
</reference>
- <!-- Keep this comment at the end of the file
+<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
@@ -155,5 +277,7 @@
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
-->
-
