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:
