cynic Fri Jan 26 01:38:02 2001 EDT
Added files:
/phpdoc/cs/functions exec.xml
Log:
translated
Index: phpdoc/cs/functions/exec.xml
+++ phpdoc/cs/functions/exec.xml
<reference id="ref.exec">
<title>Funkce Spou�t�n� Program�</title>
<titleabbrev>Spou�t�n� Program�</titleabbrev>
<refentry id="function.escapeshellarg">
<refnamediv>
<refname>escapeshellarg</refname>
<refpurpose>escape a string to be used as a shell argument</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>escapeshellarg</function></funcdef>
<paramdef>string <parameter>arg</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
<function>EscapeShellArg</function> p�id� jednoduch� uvozovky na za��tek
a konec �et�zce a ouvozovkuje/escapes v�echny v�skyty jednoduch�ch uvozovek,
tak�e tento �et�zec m��ete p��mo p�edat shell funkci, p�i�em� tento bude
br�n jako bezpe�n� argument. Tato funkce by se m�la pou��vat k oescapov�n�
jednotliv�ch argument� ur�en�ch pro shell funkce poch�zej�c�ch z
u�ivatelsk�ho vstupu. Shell funkce zahrnuj�c <function>exec</function>,
<function>system</function> a
<link linkend="language.operators.execution">backtick operator</link>.
Standardn� pou�it�:</para>
<para>
<informalexample>
<programlisting role="php">
system("ls ".EscapeShellArg($dir))
</programlisting>
</informalexample>
</para>
<para>
Viz tak� <function>exec</function>, <function>popen</function>,
<function>system</function>, a <link
linkend="language.operators.execution">backtick oper�tor</link>.
</para>
</refsect1>
</refentry>
<refentry id="function.escapeshellcmd">
<refnamediv>
<refname>escapeshellcmd</refname>
<refpurpose>escape shellovsk� metaznaky</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>escapeshellcmd</function></funcdef>
<paramdef>string <parameter>command</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
<function>EscapeShellCmd</function> oescapuje v�echny znaky v �et�zci,
kter� by se daly pou��t ke zneu�it� shellov�ho p��kazu k vykon�n� libovoln�ch
p��kaz�. Tato funkce by se m�la pou��vat k zabezpe�en� toho, aby v�echna
data poch�zej�c� z u�ivatelsk�ho vstupu byla oescapov�na p�et�m, ne� budou
p�ed�na funkci <function>exec</function> nebo <function>system</function>,
nebo <link linkend="language.operators.execution">backtick oper�toru</link>.
Standardn� pou�it�:</para>
<para>
<informalexample>
<programlisting role="php">
$e = EscapeShellCmd($userinput);
system("echo $e"); // tady n�s nezaj�m�, jestli jsou v $e mezery
$f = EscapeShellCmd($filename);
system("touch \"/tmp/$f\"; ls -l \"/tmp/$f\""); // a tady ano, proto pou�ijeme uvozovky
</programlisting>
</informalexample>
</para>
<para>
Viz tak�<function>escapeshellarg</function>, <function>exec</function>,
<function>popen</function>, <function>system</function>, a <link
linkend="language.operators.execution">backtick oper�tor</link>.
</para>
</refsect1>
</refentry>
<refentry id="function.exec">
<refnamediv>
<refname>exec</refname>
<refpurpose>Prov�st extern� program</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</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>
<function>exec</function> prov�d� p�edan� <parameter>command</parameter>,
nicm�n� nic netiskne. Pouze vrac� posledn� ��dek v�stupu dan�ho p��kazu.
Pokud pot�ebujete prov�st p��kaz a nechat v�echna data z tohoto p��kazu
p�edat rovnou bez jak�hokoli z�sahu, pou�ijte funkci
<function>PassThru</function>.
</para>
<para>
Pokud je p��tomen argument <parameter>array</parameter>, p�edan� pole se
napln� v�emi ��dky v�stupu dan�ho p��kazu. Pozn.: Pokud toto pole u� obsahuje
n�jak� prvky, <function>exec</function> p�ipoj� tento v�stup na konec tohoto
pole. Pokud nechcete, aby tato funkce p�ipojovala prvky na konec dan�ho
pole, zavolejte na toto pole <function>unset</function> p�edt�m, ne� ho
p�ed�te funkci <function>exec</function>.
</para>
<para>
Pokud je vedle argumentu <parameter>array</parameter> p��tomen argument
<parameter>return_var</parameter>, n�vratov� hodnota proveden�ho
p��kazu se zap��e do t�to prom�nn�.
</para>
<para>
Pozn.: Pokud chcete pou��vat v t�to funkci data z u�ivatelsk�ho vstupu,
m�li byste pou��vat <function>EscapeShellCmd</function>, abyste m�li jistotu,
�e u�ivatel� nevmanipuluj� syst�m do prov�d�n� libovoln�ch p��kaz�.
</para>
<para>
Pozn.: Pokud touto funkc� nastartujete n�jak� program a chcete ho nechat
b�et v pozad�, mus�te se zajistit p�esm�rov�n� v�stupu z tohoto programu
do souboru nebo jineho v�stupn�ho streamu, jinak se PHP zasekne a� do
ukon�en� b�hu tohoto programu.
</para>
<para>
Viz tak�<function>system</function>,
<function>PassThru</function>, <function>popen</function>,
<function>EscapeShellCmd</function>, a <link
linkend="language.operators.execution">backtick oper�tor</link>.
</para>
</refsect1>
</refentry>
<refentry id="function.passthru">
<refnamediv>
<refname>passthru</refname>
<refpurpose>
Vykonat extern� program a zobrazit nezpracovan� v�stup
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</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>
Funkce <function>passthru</function> se podob� funkci
<function>Exec</function> v tom ohledu, �e provede
<parameter>command</parameter>. Pokud je p��tomen argument
<parameter>return_var</parameter>, n�vratov� hodnota tohoto p��kazu se
um�st� sem. Tato funkce by se m�la pou��vat m�sto
<function>Exec</function> a
<function>System</function>, pokud jsou v�stupem dan�ho p��kazu bin�rn�
data, kter� je pot�eba odeslat p��mo do browseru. B�n�m pou�it�m t�to
funkce vykonat nap�. pbmplus utility, kter� mohou poslat stream obr�zku
na stdout. Nastaven�m content-type na <emphasis>image/gif</emphasis> a
zavol�n�m pbmplus programu k odesl�n� gifu na stdout gifu m��ete vytvo�it
PHP skripty, kter� p��mo tvo�� obr�zky.
</para>
<para>
Pozn.: Pokud touto funkc� nastartujete n�jak� program a chcete ho nechat
b�et v pozad�, mus�te se zajistit p�esm�rov�n� v�stupu z tohoto programu
do souboru nebo jineho v�stupn�ho streamu, jinak se PHP zasekne a� do
ukon�en� b�hu tohoto programu.
</para>
<para>
Viz tak�<function>exec</function>, <function>system</function>,
<function>popen</function>, <function>EscapeShellCmd</function>,
a <link linkend="language.operators.execution">backtick oper�tor</link>.
</para>
</refsect1>
</refentry>
<refentry id="function.system">
<refnamediv>
<refname>system</refname>
<refpurpose>Prov�st extern� program a zobrazit v�stup</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</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>
<function>system</function> je verz� stejnojmenn� C funkce; vykon� p�edan�
<parameter>command</parameter> a zobraz� v�stup. Pokud j� p�ed�te prom�nnou
jako druh� argument, n�vratov� hodnota proveden�ho p��kazu se zap��e do
t�to prom�nn�.
</para>
<para>
Pozn.: Pokud chcete pou��vat v t�to funkci data z u�ivatelsk�ho vstupu,
m�li byste pou��vat <function>EscapeShellCmd</function>, abyste m�li jistotu,
�e u�ivatel� nevmanipuluj� syst�m do prov�d�n� libovoln�ch p��kaz�.
</para>
<para>
Pozn.: Pokud touto funkc� nastartujete n�jak� program a chcete ho nechat
b�et v pozad�, mus�te se zajistit p�esm�rov�n� v�stupu z tohoto programu
do souboru nebo jineho v�stupn�ho streamu, jinak se PHP zasekne a� do
ukon�en� b�hu tohoto programu.
</para>
<para>
Pokud PHP b�� jako modul serveru, <function>system</function> tak�
automaticky flushne v�stupn� buffer web serveru po ka�d�m ��dku v�stupu.
</para>
<para>
P�i �sp�chu vrac� posledn� ��dek v�stupu p��kazu, p�i selh�n�
<literal>false</literal>.
</para>
<para>
Pokud pot�ebujete prov�st p��kaz a nechat v�echna data z tohoto p��kazu
p�edat rovnou bez jak�hokoli z�sahu, pou�ijte funkci
<function>PassThru</function>.
</para>
<para>
Viz tak�<function>exec</function>,
<function>PassThru</function>, <function>popen</function>,
<function>EscapeShellCmd</function>, a <link
linkend="language.operators.execution">backtick oper�tor</link>.
</para>
</refsect1>
</refentry>
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
