goba Sat Aug 18 09:37:49 2001 EDT
Modified files:
/phpdoc/hu/functions exec.xml
Log:
Updating, new escapeshellarg() [at least it is new in the Hungrian Manual]
Index: phpdoc/hu/functions/exec.xml
diff -u phpdoc/hu/functions/exec.xml:1.3 phpdoc/hu/functions/exec.xml:1.4
--- phpdoc/hu/functions/exec.xml:1.3 Sat Jul 7 18:24:12 2001
+++ phpdoc/hu/functions/exec.xml Sat Aug 18 09:37:49 2001
@@ -1,221 +1,276 @@
- <reference id="ref.exec">
- <title>Programfuttat� f�ggv�nyek</title>
- <titleabbrev>Programfuttat�s</titleabbrev>
-
- <refentry id="function.escapeshellcmd">
- <refnamediv>
- <refname>escapeshellcmd</refname>
- <refpurpose>Shell metakarakterek escape-je</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Le�r�s</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>string <function>escapeshellcmd</function></funcdef>
- <paramdef>string <parameter>command</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <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>
- f�gg�nyh�v�sn�l, vagy egy <link
- linkend="language.operators.execution">backtick
- oper�torban</link> haszn�ln�d. Egy hagyom�nyos haszn�lati forma:</para>
- <para>
- <informalexample>
- <programlisting role="php">
+<reference id="ref.exec">
+ <title>Programfuttat� f�ggv�nyek</title>
+ <titleabbrev>Programfuttat�s</titleabbrev>
+
+ <partintro>
+ <simpara>
+ Ezek a f�ggv�nyek k�l�nb�z� k�ls� program futtat�s�ra
+ adnak lehet�s�get, vagy seg�tik biztons�gosabb� tenni
+ ezeket a h�v�sokat. �rdemes megn�zned a
+ <link linkend="language.operators.execution">v�grehajt� oper�tort</link>
+ is.
+ </simpara>
+ </partintro>
+
+ <refentry id="function.escapeshellarg">
+ <refnamediv>
+ <refname>escapeshellarg</refname>
+ <refpurpose>Shell param�terk�nt �tadand� karakterl�ncot �ll�t el�</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Le�r�s</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>escapeshellarg</function></funcdef>
+ <paramdef>string <parameter>arg</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <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:
+ </para>
+ <para>
+ <informalexample>
+ <programlisting role="php">
+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>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.escapeshellcmd">
+ <refnamediv>
+ <refname>escapeshellcmd</refname>
+ <refpurpose>Shell metakaraktereket alak�t �t</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Le�r�s</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>escapeshellcmd</function></funcdef>
+ <paramdef>string <parameter>command</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <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>
+ 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:
+ </para>
+ <para>
+ <informalexample>
+ <programlisting role="php">
<![CDATA[
-system(EscapeShellCmd($parancs))
+$e = escapeshellcmd($parancs);
+system("echo $e"); // itt mindegy, hogy az $e tartalmaz-e sz�k�zt
+$f = escapeshellcmd($filenev);
+system("touch \"/tmp/$f\"; ls -l \"/tmp/$f\""); // itt viszont nem, ez�rt van
+id�z�jelben
]]>
- </programlisting>
- </informalexample>
+ </programlisting>
+ </informalexample>
+ </para>
+ <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>.
</para>
- <para>
- L�sd m�g: <function>exec</function>, <function>popen</function>,
- <function>system</function> �s a <link
- linkend="language.operators.execution">backtick oper�tor</link>.
- </para>
-
- </refsect1>
- </refentry>
+ </refsect1>
+ </refentry>
- <refentry id="function.exec">
- <refnamediv>
- <refname>exec</refname>
- <refpurpose>Egy k�ls� program futtat�sa</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Le�r�s</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>string <function>exec</function></funcdef>
- <paramdef>string <parameter>command</parameter></paramdef>
- <paramdef>string
- <parameter><optional>array</optional>
- </parameter>
- </paramdef>
- <paramdef>int
- <parameter><optional>return_var</optional></parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
- <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 k�zben
- minden adat feldolgoz�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�si st�tusza 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 user-ek 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 le fog �llni, miut�n a program fut�sa befejez�d�tt.
- </para>
- <para>
- L�sd m�g: <function>system</function>,
- <function>passthru</function>, <function>popen</function>,
- <function>escapeshellcmd</function> �s a <link
- linkend="language.operators.execution">backtick oper�tor</link>.
- </para>
- </refsect1>
- </refentry>
+ <refentry id="function.exec">
+ <refnamediv>
+ <refname>exec</refname>
+ <refpurpose>K�ls� programot futtat</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Le�r�s</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>exec</function></funcdef>
+ <paramdef>string <parameter>command</parameter></paramdef>
+ <paramdef>string
+ <parameter><optional>array</optional></parameter>
+ </paramdef>
+ <paramdef>int
+ <parameter><optional>return_var</optional></parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <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>
+ <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>.
+ </para>
+ </refsect1>
+ </refentry>
- <refentry id="function.passthru">
- <refnamediv>
- <refname>passthru</refname>
- <refpurpose>
- K�ls� program futtat�sa �s a kimenet feldolgoz�s n�lk�li megjelen�t�se
+ <refentry id="function.passthru">
+ <refnamediv>
+ <refname>passthru</refname>
+ <refpurpose>
+ K�ls� programot futtat, �s a kimenetet feldolgoz�s n�lk�li jelen�ti meg
</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Le�r�s</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>void <function>passthru</function></funcdef>
- <paramdef>string <parameter>command</parameter></paramdef>
- <paramdef>int
+ </refnamediv>
+ <refsect1>
+ <title>Le�r�s</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>void <function>passthru</function></funcdef>
+ <paramdef>string <parameter>command</parameter></paramdef>
+ <paramdef>int
<parameter><optional>return_var</optional></parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
- <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 visszat�r�si st�tusza a parancsnak
- 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 scriptet, 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 le fog �llni, miut�n a program fut�sa befejez�d�tt.
- </para>
- <para>
- L�sd m�g: <function>exec</function>, <function>system</function>,
- <function>popen</function>, <function>escapeshellcmd</function>,
- �s a <link linkend="language.operators.execution">backtick
- oper�tor</link>.
- </para>
- </refsect1>
- </refentry>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <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>
+ <para>
+ L�sd m�g: <function>exec</function>, <function>system</function>,
+ <function>popen</function>, <function>escapeshellcmd</function>,
+ �s a <link linkend="language.operators.execution">v�grehajt�
+ oper�tor</link>.
+ </para>
+ </refsect1>
+ </refentry>
- <refentry id="function.system">
- <refnamediv>
- <refname>system</refname>
- <refpurpose>K�ls� program futtat�sa �s a kimenet feldolgoz�s n�lk�li
megjelen�t�se</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Le�r�s</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>string <function>system</function></funcdef>
- <paramdef>string <parameter>command</parameter></paramdef>
- <paramdef>int
+ <refentry id="function.system">
+ <refnamediv>
+ <refname>system</refname>
+ <refpurpose>
+ K�ls� programot futtat, �s a kimenetet megjelen�ti
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Le�r�s</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>system</function></funcdef>
+ <paramdef>string <parameter>command</parameter></paramdef>
+ <paramdef>int
<parameter><optional>return_var</optional></parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- A <function>system</function> f�ggv�ny olyan, mint
- C-beli testv�re, ami 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�si
- st�tusz 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 user-ek 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 le fog �llni, miut�n a program fut�sa befejez�d�tt.
- </para>
- <para>
- A <function>system</function> f�ggv�ny automatikusan �r�teni
- pr�b�lja a szerver kimeneti buffer�t minden kiadott sor ut�n, ha
- a PHP szerver modulk�nt fut.
- </para>
- <para>
- Visszaadja a parancs kimenet�nek utols� sor�t siker eset�n,
- vagy &false; �rt�ket ha hiba t�rt�nik.
- </para>
- <para>
- Ha le kell futtatnod egy parancsot, �s ki kell adnod muinden
- kimenet�t feldolgoz�s n�lk�l, haszn�ld az
- <function>passthru</function> f�ggv�nyt.
- </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">backtick oper�tor</link>.
- </para>
- </refsect1>
- </refentry>
-
- </reference>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ A <function>system</function> f�ggv�ny olyan, mint
+ C-beli testv�re, 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.
+ </para>
+ <para>
+ A <function>system</function> f�ggv�ny automatikusan �r�teni
+ pr�b�lja a szerver kimeneti buffer�t minden kiadott sor ut�n,
+ ha a PHP szerver modulk�nt fut.
+ </para>
+ <para>
+ Visszaadja a parancs kimenet�nek utols� sor�t siker eset�n,
+ 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.
+ </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>.
+ </para>
+ </refsect1>
+ </refentry>
+</reference>
<!-- Keep this comment at the end of the file
Local variables:
