PHP: passthru - Manual

Описание

void passthru ( string command [, int &return_var] )

The passthru() function is similar to the exec() function in that it executes a command. If the return_var argument is present, the return status of the Unix command will be placed here. This function should be used in place of exec() or system() when the output from the Unix command is binary data which needs to be passed directly back to the browser. A common use for this is to execute something like the pbmplus utilities that can output an image stream directly. By setting the Content-type to image/gif and then calling a pbmplus program to output a gif, you can create PHP scripts that output images directly.

Внимание

Если вы собираетесь передавать функции данные, отправленные пользователем, вы должны использовать функции escapeshellarg() или escapeshellcmd() для того, чтобы обезопасить исполнение комманд.

Замечание: Если вы собираетесь использовать эту функцию в программе, работающей в качестве демона, убедитесь, что стандартный вывод функции направлен в файл или другой поток, в противном случае PHP зависнет вплоть до конца выполнения программы.

Замечание: В случае работы в безопасном режиме, вы можете запускать что-либо только в пределах safe_mode_exec_dir. В настоящее время, использование .. в пути запрещено

Внимание

В случае работы в безопасном режиме, все слова, следующие за начальной командой, рассматриваются как единый аргумент. То есть echo y | echo x будет работать как echo "y | echo x".

add a note User Contributed Notes
passthru

sarel dot w at envent dot co dot za
09-Mar-2005 02:33


Zak Estrada

14-Dec-2004 11:21 

Remember to use the full path (IE '/usr/local/bin/foo' instead of 'foo') when using passthru, otherwise you'll get an exit code of 127 (command not found).



Remember, you'll also get this error if your file does not have executable permission.

puppy at cyberpuppy dot org
02-Mar-2005 05:50


Regarding swbrown's comment...you need to use an output buffer if you don't want the data displayed.



For example:

ob_start();

passthru("<i>command</i>");

$var = ob_get_contents();

ob_end_clean(); //Use this instead of ob_flush()



This gets all the output from the command, and exits without sending any data to stdout.

Zak Estrada
14-Dec-2004 11:21


Remember to use the full path (IE '/usr/local/bin/foo' instead of 'foo') when using passthru, otherwise you'll get an exit code of 127 (command not found).

php @ richud dot com
27-May-2004 11:30


Regarding kpierre's post, be mindful that if you shell script errors, you will find the error output from it in the base error_log file (not virtualhost error_log) in apache.

jcr at marvel-databadge dot com
04-Sep-2003 02:23


With apache 2.x on RH9 passthru() writes 1 byte at a time. Apache 2.x buffers and chunk encodes the output for you - but the chunked encoding devides the output in chunks of 1 byte each...thus several bytes of overhead per byte. I guess that buffering behaviour is by design - but caused problems for me with IE adobe acrobot 5 plugin. The plugin doesn't like like it if you send it a stream of 1 byte chunks - it tells you your file is not a pdf or gives a blank screen. Using output buffering (ob_start / ob_endflush) gives reasonable size chunks and the plugin works OK.

swbrown at ucsd dot edu
03-Jun-2003 11:41


passthru() seems absolutely determined to buffer output no matter what you do, even with ob_implicit_flush().  The solution seems to be to use popen() instead.

kpierre at fit dot edu
30-Jan-2002 10:35


The documention does not mention that passthru() will only display standard output and not standard error.



If you are running a script you can pipe the STDERR to STDOUT by doing 



exec 2>&1



Eg. the script below will actually print something with the passthru() function...



#!/bin/sh

exec 2>&1

ulimit -t 60

cat nosuchfile.txt

mike at ftl dot com
22-Jan-2002 06:29


In reference to aborted scripts hanging. You can set 'ignore_user_abort(true);' in your script and it does exactly that. 



 It causes the browser to stop loading but the script will continue.

andreas dot hochsteger at oeamtc dot at
03-Oct-2001 10:51


If you sometimes get no output from passthru() use system() instead. This solved this problem for me (php 4.0.5 on Tru64 Unix compiled with gcc).

sidney at jigsaw dot nl
20-Jun-2001 08:25


PJ's ulimit example is nice; however, if you include multiple commands in the script after the ulimit command, each gets its own, seperate 60 second time slot!<br>




Furthermore, these sixty seconds are *CPU* time. Most programs hang for other reasons than CPU hogging (for example, waiting for a database connection) so for most purposes the number 60 is rather too high.<br>




Try "ulimit -t 1" first, which will give you about 10^9 cycles on modern hardware -- quite enough to get a lot of work done!

PJ at piggei dot com
14-Feb-2001 08:06


About the problem of zombies, you may call a bash script like this:




--------------------------


#! /bin/bash


ulimit -t 60




<your command here>


--------------------------

add a note