passthru

(PHP 3, PHP 4 >= 4.0.0)

passthru --  Külső programot futtat, és a kimenetet feldolgozás nélküli jeleníti meg

Leírás

void passthru (string command [, int return_var])

A passthru() függvény hasonló az exec()-hez, ugyanis a command paraméterben megadott parancsot futtatja. Ha a return_var paraméter adott, akkor a parancs visszatérés-ideji állapota ebbe a változóba kerül. Ezt a függvényt használd az exec() vagy system() helyett, ha a parancs kimenete bináris adat, amit közvetlenül a böngészőnek kell visszaküldeni. Tipikusan például a pbmplus eszközök futtatására használható, amik képesek közvetlenül kép visszaadására. Ha a Content-type fejlécet image/gif-re állítod, és meghívod a pbmplus programot, ami visszaad egy képet, készíthetsz olyan PHP programot, ami közevtelnül képet ad vissza.

Ha ezzel a függvénnyel el szeretnél indítani egy programot, amit utána a háttérben futni hagsz, meg kell róla győződnöd, hogy a program kimenete egy file-ba kerül átirányításra, vagy valamilyen más kimeneti csatornára. Ellenkező esetben a PHP várakozni fog addig, amíg a program futása be nem fejeződött.

Lásd még: exec(), system(), popen(), escapeshellcmd(), és a végrehajtó operátor.