File: exec.xml

package info (click to toggle)
phpdoc 20020310-1
  • links: PTS
  • area: main
  • in suites: woody
  • size: 35,272 kB
  • ctags: 354
  • sloc: xml: 799,767; php: 1,395; cpp: 500; makefile: 200; sh: 140; awk: 51
file content (306 lines) | stat: -rw-r--r-- 11,283 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
<?xml version="1.0" encoding="iso-8859-2"?>
<!-- EN-Revision: 1.27 Maintainer: goba Status: ready -->

<reference id="ref.exec">
 <title>Programfuttat fggvnyek</title>
 <titleabbrev>Programfuttats</titleabbrev>

 <partintro>
  <simpara>
   Ezek a fggvnyek klnbz kls program futtatsra
   adnak lehetsget, vagy segtik biztonsgosabb tenni
   ezeket a hvsokat. rdemes megnzned a
   <link linkend="language.operators.execution">vgrehajt opertort</link>
   is.
  </simpara>
 </partintro>

 <refentry id="function.escapeshellarg">
  <refnamediv>
   <refname>escapeshellarg</refname>
   <refpurpose>Shell paramterknt tadand karakterlncot llt el</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Lers</title>
    <methodsynopsis>
     <type>string</type><methodname>escapeshellarg</methodname>
     <methodparam><type>string</type><parameter>arg</parameter></methodparam>
    </methodsynopsis>
   <para>
    Az <function>escapeshellarg</function> aposztrfok kz fogja az 
    <parameter>arg</parameter> paramterben tadott szveget s megkettzi a 
    benne lv aposztrfokat, gy egy parancsrtelmez fggvnyek nll
    paramtereknt hasznlhat karaktersorozatot ad vissza. Ez a fggvny 
    hasznlatos a felhasznltl rkez egyedi parancsrtelmez fggvnyek 
    paramtereinek biztonsgoss alaktsra. Ezek a fgvnyek : az 
    <function>exec</function>, a <function>system</function> s a <link 
    linkend="language.operators.execution">vgrehajt opertor</link>. 
    Jellemz hasznlata:
   </para>
   <para>
    <informalexample>
     <programlisting role="php">
<![CDATA[
system("ls ".escapeshellarg($dir));
]]>
     </programlisting>
    </informalexample>
   </para>
   <para>
    Lsd mg: <function>exec</function>, <function>popen</function>,
    <function>system</function> s a <link
    linkend="language.operators.execution">vgrehajt opertor</link>!
   </para>
  </refsect1>
 </refentry>

 <refentry id="function.escapeshellcmd">
  <refnamediv>
   <refname>escapeshellcmd</refname>
   <refpurpose>Shell metakaraktereket alakt t</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Lers</title>
    <methodsynopsis>
     <type>string</type><methodname>escapeshellcmd</methodname>
     <methodparam><type>string</type><parameter>command</parameter></methodparam>
    </methodsynopsis>
   <para>
    Az <function>escapeshellcmd</function> escape-et alkalmaz minden
    specilis karakterre, ami nem kvnt parancsok futtatst okozn.
    Ez a fggvny arra hasznlhat, hogy biztostsd a felhasznltl rkez adat
    tisztasgt egy <function>exec</function> vagy egy <function>system</function>
    fggnyhvsnl, vagy egy <link linkend="language.operators.execution">vgrehajt
    opertorban</link> hasznlnd. ltalnos hasznlati forma:
   </para>
   <para>
    <informalexample>
     <programlisting role="php">
<![CDATA[
$e = escapeshellcmd($parancs);
system("echo $e"); // itt mindegy, hogy az $e tartalmaz-e szkzt
$f = escapeshellcmd($filenev);
system("touch \"/tmp/$f\"; ls -l \"/tmp/$f\""); // itt viszont nem, ezrt van idzjelben
]]>
     </programlisting>
    </informalexample>
   </para>
   <para>
     Lsd mg: <function>escapeshellarg</function>, <function>exec</function>,
     <function>popen</function>, <function>system</function>
     s a <link linkend="language.operators.execution">vgrehajt opertor</link>!
    </para>
  </refsect1>
 </refentry>

 <refentry id="function.exec">
  <refnamediv>
   <refname>exec</refname>
   <refpurpose>Kls programot futtat</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Lers</title>
    <methodsynopsis>
     <type>string</type><methodname>exec</methodname>
     <methodparam><type>string</type><parameter>command</parameter></methodparam>
     <methodparam choice="opt"><type>string</type><parameter>array</parameter></methodparam>
     <methodparam choice="opt"><type>int</type><parameter>return_var</parameter></methodparam>
    </methodsynopsis>
   <para>
    Az <function>exec</function> lefuttatja a 
    <parameter>command</parameter>-ban megadott parancsot, amely gy nem r ki
    semmit, csak egyszeren visszaadja a legutols sort, amit a parancs
    generlt. A <function>passthru</function> fggvny hasznlhat arra, hogy
    a parancs eredmnye minden adatfeldolgozs nlkl kirsa kerljn.
   </para>
   <para>
    Az <parameter>array</parameter> paramter megadsval a program kimenett
    a PHP soronknt a megadott tmb vghez fzi. Ha az tadott tmb mr 
    tartalmaz nhny elemet, akkor az <function>exec</function> a benne lv
    adatok utn fzi a sorokat. Ha nincs szksg a rgi elemekre, akkor az
    <function>unset</function> fggvnnyel lehet trlni az egsz tmbt,
    az <function>exec</function> meghvsa eltt.
   </para>
   <para>
    Az <parameter>array</parameter> paramterrel egytt a 
    <parameter>return_var</parameter> a futtatott parancs visszatrsi 
    llapott trolja el.
   </para>
   <warning>
    <para>
     Ha felhasznltl szrmaz adatot kell tadni ennek a fggvnynek, akkor 
     eltte hasznld az <function>escapeshellcmd</function> fggvnyt, annak
     biztostsra, hogy nem tudnak a felhasznlk tetszleges parancsot 
     futtatni.
    </para>
   </warning>
   <note>
    <para>
     Ezzel a fggvnnyel elindtott de httrben fut program kimenett
     mindenkppen fjlba vagy valamilyen ms kimeneti csatornba kell
     tirnytani. Ellenkez esetben a PHP vrakozni fog addig, amg a 
     program futsa be nem fejezdik.
    </para>
   </note>
   <para>
    Lsd mg: <function>system</function>,
    <function>passthru</function>, <function>popen</function>,
    <function>escapeshellcmd</function> s a
    <link linkend="language.operators.execution">vgrehajt opertor</link>!
   </para>
  </refsect1>
 </refentry>

 <refentry id="function.passthru">
  <refnamediv>
   <refname>passthru</refname>
   <refpurpose>
    Kls programot futtat, s a kimenetet feldolgozs nlkli jelenti meg
    </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Lers</title>
    <methodsynopsis>
     <type>void</type><methodname>passthru</methodname>
     <methodparam><type>string</type><parameter>command</parameter></methodparam>
     <methodparam choice="opt"><type>int</type><parameter>return_var</parameter></methodparam>
    </methodsynopsis>
   <para>
    A <function>passthru</function> fggvny hasonl az
    <function>exec</function>-hez, ugyanis a <parameter>command</parameter> 
    paramterben megadott parancsot futtatja. A <parameter>return_var</parameter>
    paramterben a parancs visszatrsi llapota kerl. Ez a fggvny 
    hasznlhat az <function>exec</function> vagy a <function>system</function>
    helyett, ha a parancs kimenete binris adat, amit kzvetlenl a bngsznek
    kell visszakldeni. Tipikusan pldul a pbmplus eszkzk futtatsra 
    hasznlhat, amelyek kpesek kzvetlenl kp visszaadsra. A
    <literal>Content-type</literal> fejlcet <emphasis>image/gif</emphasis>-re
    lltva s a pbmplus programot meghvva, az visszaad egy kpet, s gy olyan 
    PHP programot rhatk, amelyek kzvetlenl kpeket adnak vissza.
   </para>
   <warning>
    <para>
     Ha felhasznltl szrmaz adatot kell tadni ennek a fggvnynek, akkor 
     eltte hasznld az <function>escapeshellcmd</function> fggvnyt, annak
     biztostsra, hogy nem tudnak a felhasznlk tetszleges parancsot 
     futtatni.
    </para>
   </warning>
   <note>
    <para>
     Ezzel a fggvnnyel elindtott de httrben fut program kimenett
     mindenkppen fjlba vagy valamilyen ms kimeneti csatornba kell
     tirnytani. Ellenkez esetben a PHP vrakozni fog addig, amg a 
     program futsa be nem fejezdik.
    </para>
   </note>
   <para>
    Lsd mg: <function>exec</function>, <function>system</function>,
    <function>popen</function>, <function>escapeshellcmd</function>
    s a <link linkend="language.operators.execution">vgrehajt
    opertor</link>!
   </para>
  </refsect1>
 </refentry>

 <refentry id="function.system">
  <refnamediv>
   <refname>system</refname>
   <refpurpose>
    Kls programot futtat, s a kimenetet megjelenti
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Lers</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>
   <para>
    A <function>system</function> fggvny olyan, mint 
    C-beli trsa, azaz a <parameter>command</parameter>
    paramterben megadott parancsot futtaja, s kirja a kimenetet.
    A <parameter>return_var</parameter> paramterben a parancs visszatrsi 
    llapota kerlhet, ha szerepel.
   </para>
   <warning>
    <para>
     Ha felhasznltl szrmaz adatot kell tadni ennek a fggvnynek, akkor 
     eltte hasznld az <function>escapeshellcmd</function> fggvnyt, annak
     biztostsra, hogy nem tudnak a felhasznlk tetszleges parancsot 
     futtatni.
    </para>
    </warning>
   <note>
    <para>
     Ezzel a fggvnnyel elindtott de httrben fut program kimenett
     mindenkppen fjlba vagy valamilyen ms kimeneti csatornba kell
     tirnytani. Ellenkez esetben a PHP vrakozni fog addig, amg a 
     program futsa be nem fejezdik.
    </para>
   </note>
   <para>
    A <function>system</function> fggvny automatikusan rteni
    prblja a szerver kimeneti puffert minden kiadott sor utn,
    ha a PHP szerver modulknt fut.
   </para>
   <para>
    Visszaadja a parancs kimenetnek utols sort siker esetn,
    vagy &false; rtket ha hiba trtnik.
   </para>
   <para>
    A <function>passthru</function> fggvny hasznlhat arra, hogy a
    parancs eredmnye minden adatfeldolgozs nlkl kirsa kerljn.
   </para>
   <para>
    Lsd mg: <function>exec</function>,
    <function>passthru</function>, <function>popen</function>,
    <function>escapeshellcmd</function> s a
    <link linkend="language.operators.execution">vgrehajt opertor</link>!
   </para>
  </refsect1>
 </refentry>

 <refentry id='function.shell-exec'>
  <refnamediv>
   <refname>shell_exec</refname>
   <refpurpose>
     lefuttat parancsrtelmezben egy parancsot s a teljes kimenetet visszaadja
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Lers</title>
   <methodsynopsis>
    <type>string</type><methodname>shell_exec</methodname>
    <methodparam><type>string</type><parameter>cmd</parameter></methodparam>
   </methodsynopsis>
   <para>
    Ez a fggvny azonos a <link
    linkend="language.operators.execution">vgrehajt opertorral</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
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
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
-->