sigmasternchen/php-doc-en
1
0
Fork 0
mirror of https://github.com/sigmasternchen/php-doc-en synced 2025-03-16 08:58:56 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

format notes using <note> and <warning> as appropriate

Browse source 
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@65518 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
jim winstead 2001-12-17 22:53:19 +00:00
parent c261125d69
commit 83952b5075
1 changed files with 53 additions and 35 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

88
functions/exec.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.24 $ -->
<!-- $Revision: 1.25 $ -->
<reference id="ref.exec">
<title>Program Execution functions</title>
<titleabbrev>Program Execution</titleabbrev>
@ -139,19 +139,23 @@ system("touch \"/tmp/$f\"; ls -l \"/tmp/$f\""); // and here we do, so we use quo
return status of the executed command will be written to this
variable.
</para>
<para>
Note that if you are going to allow data coming from user input
to be passed to this function, then you should be using
<function>escapeshellcmd</function> to make sure that users
cannot trick the system into executing arbitrary commands.
</para>
<para>
Note also that if you start a program using this function and
want to leave it running in the background, you have to make
sure that the output of that program is redirected to a file or
some other output stream or else PHP will hang until the
execution of the program ends.
</para>
<warning>
<para>
If you are going to allow data coming from user input to be passed to
this function, then you should be using
<function>escapeshellarg</function> or
<function>escapeshellcmd</function> to make sure that users cannot trick
the system into executing arbitrary commands.
</para>
</warning>
<note>
<para>
If you start a program using this function and want to leave it running
in the background, you have to make sure that the output of that program
is redirected to a file or some other output stream or else PHP will
hang until the execution of the program ends.
</para>
</note>
<para>
See also <function>system</function>,
<function>passthru</function>, <function>popen</function>,
@ -192,14 +196,25 @@ system("touch \"/tmp/$f\"; ls -l \"/tmp/$f\""); // and here we do, so we use quo
pbmplus utilities that can output an image stream directly. By
setting the Content-type to <emphasis>image/gif</emphasis> and
then calling a pbmplus program to output a gif, you can create
PHP scripts that output images directly.</para>
<para>
Note that if you start a program using this function and want to
leave it running in the background, you have to make sure that the
output of that program is redirected to a file or some other
output stream or else PHP will hang until the execution of the
program ends.
PHP scripts that output images directly.
</para>
<warning>
<para>
If you are going to allow data coming from user input to be passed to
this function, then you should be using
<function>escapeshellarg</function> or
<function>escapeshellcmd</function> to make sure that users cannot trick
the system into executing arbitrary commands.
</para>
</warning>
<note>
<para>
If you start a program using this function and want to leave it running
in the background, you have to make sure that the output of that program
is redirected to a file or some other output stream or else PHP will
hang until the execution of the program ends.
</para>
</note>
<para>
See also <function>exec</function>, <function>system</function>,
<function>popen</function>, <function>escapeshellcmd</function>,
@ -233,20 +248,23 @@ system("touch \"/tmp/$f\"; ls -l \"/tmp/$f\""); // and here we do, so we use quo
status code of the executed command will be written to this
variable.
</para>
<para>
Note, that if you are going to allow data coming from user input
to be passed to this function, then you should be using the
<function>escapeshellcmd</function> function to make sure that
users cannot trick the system into executing arbitrary
commands.
</para>
<para>
Note also that if you start a program using this function and want
to leave it running in the background, you have to make sure that
the output of that program is redirected to a file or some other
output stream or else PHP will hang until the execution of the
program ends.
</para>
<warning>
<para>
If you are going to allow data coming from user input to be passed to
this function, then you should be using
<function>escapeshellarg</function> or
<function>escapeshellcmd</function> to make sure that users cannot trick
the system into executing arbitrary commands.
</para>
</warning>
<note>
<para>
If you start a program using this function and want to leave it running
in the background, you have to make sure that the output of that program
is redirected to a file or some other output stream or else PHP will
hang until the execution of the program ends.
</para>
</note>
<para>
The <function>system</function> call also tries to automatically
flush the web server's output buffer after each line of output if