From 036eaef97228bbc58279474d31c8076772ca4cd3 Mon Sep 17 00:00:00 2001 From: Egon Schmid Date: Fri, 11 Feb 2000 20:24:50 +0000 Subject: [PATCH] Some cosmetic changes. git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@19571 c90b9560-bf6c-de11-be94-00142212c4b1 --- functions/exec.xml | 150 ++++++++++++++++++++++++++------------------- 1 file changed, 88 insertions(+), 62 deletions(-) diff --git a/functions/exec.xml b/functions/exec.xml index 0edf8c3011..e92fac44b0 100644 --- a/functions/exec.xml +++ b/functions/exec.xml @@ -24,17 +24,16 @@ operator. A standard use would be: - + system(EscapeShellCmd($cmd)) - - - - See also exec, popen, - system, and the backtick operator. - + + + See also exec, popen, + system, and the backtick operator. + @@ -49,51 +48,67 @@ system(EscapeShellCmd($cmd)) string exec string command - string array - int return_var + string + array + + + int + return_var + - - exec executes the given command, however it does not - output anything. It simply returns the last line from the result of the command. - If you need to execute a command and have all the data from the command passed - directly back without any interference, use the PassThru - function. + exec executes the given + command, however it does not output + anything. It simply returns the last line from the result of the + command. If you need to execute a command and have all the data + from the command passed directly back without any interference, + use the PassThru function. + - If the array argument is present, then the specified array will be filled - with every line of output from the command. Note that if the array already contains some - elements, exec will append to the end of the array. If you do not - want the function to append elements, call unset on the array before - passing it to exec. + If the array argument is present, then the + specified array will be filled with every line of output from the + command. Note that if the array already contains some elements, + exec will append to the end of the array. + If you do not want the function to append elements, call + unset on the array before passing it to + exec. + - If the return_var argument is present along with the array - argument, then the return status of the executed command will be written to this - variable. + If the return_var argument is present + along with the array argument, then the + return status of the executed command will be written to this + variable. + - Note that if you are going to allow data coming from user input to be - passed to this function, then you should be using EscapeShellCmd - to make sure that users cannot trick the system into executing arbitrary commands. - + Note that if you are going to allow data coming from user input + to be passed to this function, then you should be using + EscapeShellCmd to make sure that users + cannot trick the system into executing arbitrary commands. + - See also system, - PassThru, popen, - EscapeShellCmd, and the backtick operator. - + See also system, + PassThru, popen, + EscapeShellCmd, and the backtick operator. + passthru - Execute an external program and display raw output + + Execute an external program and display raw output + Description void passthru string command - int return_var + int + return_var + The passthru function is similar to the @@ -110,11 +125,11 @@ system(EscapeShellCmd($cmd)) then calling a pbmplus program to output a gif, you can create PHP scripts that output images directly. - See also exec, - system, popen, - EscapeShellCmd, and the backtick operator. - + See also exec, system, + popen, EscapeShellCmd, + and the backtick + operator. + @@ -128,34 +143,45 @@ system(EscapeShellCmd($cmd)) string system string command - int return_var + int + return_var + - System is just like the C version of the function in that it executes - the given command and outputs the result. If a variable is provided as - the second argument, then the return status code of the executed command - will be written to this variable. + System is just like the C version of the + function in that it executes the given + command and outputs the result. If a + variable is provided as the second argument, then the return + status code of the executed command will be written to this + variable. + - 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 EscapeShellCmd function - to make sure that users cannot trick the system into executing arbitrary commands. + 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 + EscapeShellCmd function to make sure that + users cannot trick the system into executing arbitrary + commands. + - The System call also tries to automatically flush the web server's output - buffer after each line of output if PHP is running as a server module. - - Returns the last line of the command output on success, and false on failure. - + The System call also tries to automatically + flush the web server's output buffer after each line of output if + PHP is running as a server module. + - If you need to execute a command and have all the data from the command passed - directly back without any interference, use the PassThru - function. - + Returns the last line of the command output on success, and false + on failure. + - See also exec, - PassThru, popen, - EscapeShellCmd, and the backtick operator. - + If you need to execute a command and have all the data from the + command passed directly back without any interference, use the + PassThru function. + + + See also exec, + PassThru, popen, + EscapeShellCmd, and the backtick operator. +