優雅的玩PHP多程式

sunsky303發表於2018-02-07
PHP

proc_open

(PHP 4 >= 4.3.0, PHP 5, PHP 7)

proc_open — 執行一個命令，並且開啟用來輸入/輸出的檔案指標。

說明 ¶

resource proc_open ( string $cmd , array $descriptorspec , array &$pipes [, string$cwd [, array $env [, array $other_options ]]] )

類似 popen() 函式， 但是 proc_open() 提供了更加強大的控制程式執行的能力。

引數 ¶

cmd

要執行的命令

descriptorspec

一個索引陣列。 陣列的鍵表示描述符，陣列元素值表示 PHP 如何將這些描述符傳送至子程式。 0 表示標準輸入（stdin），1 表示標準輸出（stdout），2 表示標準錯誤（stderr）。

陣列中的元素可以是：

  • 包含了要傳送至程式的管道的描述資訊。 第一個元素為描述符型別， 第二個元素是針對該描述符的選項。 有效的型別有：pipe （第二個元素可以是： r 向程式傳送該管道的讀取端，w 向程式傳送該管道的寫入端）， 以及 file（第二個元素為檔名）。
  • 表達一個真實檔案描述符的流資源型別 （例如：已開啟的檔案，一個 socket 埠，STDIN）。

檔案描述符的值不限於 0，1 和 2，你可以使用任何有效的檔案描述符 並將其傳送至子程式。 這使得你的指令碼可以和其他指令碼互動操作。 例如，可以通過指定檔案描述符將密碼以更加安全的方式 傳送至諸如 PGP，GPG 和 openssl 程式， 同時也可以很方便的獲取這些程式的狀態資訊。

pipes

將被置為索引陣列， 其中的元素是被執行程式建立的管道對應到 PHP 這一端的檔案指標。

cwd

要執行命令的初始工作目錄。 必須是 絕對 路徑， 設定此引數為 NULL 表示使用預設值（當前 PHP 程式的工作目錄）。

env

要執行的命令所使用的環境變數。 設定此引數為 NULL 表示使用和當前 PHP 程式相同的環境變數。

other_options

你還可以指定一些附加選項。 目前支援的選項包括：

  • suppress_errors （僅用於 Windows 平臺）： 設定為 TRUE 表示抑制本函式產生的錯誤。
  • bypass_shell （僅用於 Windows 平臺）： 設定為 TRUE 表示繞過 cmd.exe shell。

返回值 ¶

返回表示程式的資源型別， 當使用完畢之後，請呼叫 proc_close() 函式來關閉此資源。 如果失敗，返回 FALSE。

更新日誌 ¶

版本 說明
5.2.1 為 other_options 引數增加 bypass_shell 選項。

範例 ¶

Example #1 proc_open() 例程

<?php
$descriptorspec = array(
   0 => array("pipe", "r"),  // 標準輸入，子程式從此管道中讀取資料
   1 => array("pipe", "w"),  // 標準輸出，子程式向此管道中寫入資料
   2 => array("file", "/tmp/error-output.txt", "a") // 標準錯誤，寫入到一個檔案
);

$cwd = `/tmp`;
$env = array(`some_option` => `aeiou`);

$process = proc_open(`php`, $descriptorspec, $pipes, $cwd, $env);

if (is_resource($process)) {
    // $pipes 現在看起來是這樣的：
    // 0 => 可以向子程式標準輸入寫入的控制程式碼
    // 1 => 可以從子程式標準輸出讀取的控制程式碼
    // 錯誤輸出將被追加到檔案 /tmp/error-output.txt

    fwrite($pipes[0], `<?php print_r($_ENV); ?>`);
    fclose($pipes[0]);

    echo stream_get_contents($pipes[1]);
    fclose($pipes[1]);
    

    // 切記：在呼叫 proc_close 之前關閉所有的管道以避免死鎖。
    $return_value = proc_close($process);

    echo "command returned $return_value
";
}
?>

以上例程的輸出類似於：

Array
(
    [some_option] => aeiou
    [PWD] => /tmp
    [SHLVL] => 1
    [_] => /usr/local/bin/php
)
command returned 0

註釋 ¶

Note:

Windows 相容性：超過 2 的描述符也可以作為可繼承的控制程式碼傳送到子程式。 但是，由於 Windows 的架構並不將檔案描述符和底層控制程式碼進行關聯， 所以，子程式無法訪問這樣的控制程式碼。 標準輸入，標準輸出和標註錯誤會按照預期工作。

Note:

如果你只需要單向的程式管道， 使用 popen() 函式會更加簡單。


<?php
#popen.php
$process = array();
for($i=0;$i<5;$i++)
{
    echo $i.` opening ... `.chr(10);
    $process[$i] = popen(`php `.dirname(__FILE__).`/popen_child.php`, `w`);
    sleep(1);
}

echo `OK>>`.chr(10);
sleep(3);
for($i=0;$i<5;$i++)
{
    $read = fread($process[$i], 64);
    echo $read;
    pclose($process[$i]);
    echo $i.` closed`.chr(10);
    sleep(1);
}






<?php
#popen_child.php
while(1)
{
    $echo =getmypid() .`->`. date("YmHis").chr(10);
    echo $echo ;
    system(`echo `.$echo.`> logp`);
    sleep(5);
}






 


 




 






例子1(popen):
<?php
function foo() {
    echo date(`Y-m-d H:i:s`)."
";
    echo shell_exec(`php -r `sleep(1); echo date("Y-m-d H:i:s")." by shell_exec:blocking
";``);       //阻塞
    $pipe1 =  popen(`php -r `sleep(2); echo date("Y-m-d H:i:s")." by popen1:non-blocking
";``, `r`);  //非阻塞(管道)
    $pipe2 =  popen(`php -r `sleep(1); echo date("Y-m-d H:i:s")." by popen2:non-blocking
";``, `r`);  //非阻塞(管道)
    echo date(`Y-m-d H:i:s`)."
";
    register_shutdown_function(function() use ($pipe1, $pipe2) { //事件驅動(指令碼結束事件),非同步回撥
        echo stream_get_contents($pipe1); //輸出子程式返回的資料
        echo stream_get_contents($pipe2); //輸出子程式返回的資料
        pclose($pipe1);
        pclose($pipe2);
    });
}
foo();
//輸出
2016-09-11 20:25:30
2016-09-11 20:25:31 by shell_exec:blocking
2016-09-11 20:25:31
2016-09-11 20:25:33 by popen1:non-blocking
2016-09-11 20:25:32 by popen2:non-blocking

例子2(proc_open):
<?php
function foo() {
    $proc = proc_open(
        //task.php 內容為 $arr = unserialize(stream_get_contents(STDIN)); $arr[`time`] = date(`Y-m-d H:i:s`, $arr[`time`]); echo serialize($arr);
        `/png/php/5.4.45/bin/php /home/eechen/task.php`, 
        array(
            0 => array(`pipe`,`r`), //stdin (用fwrite寫入資料給管道)
            1 => array(`pipe`,`w`), //stdout(用stream_get_contents獲取管道輸出)
            2 => array(`pipe`,`w`), //stderr(用stream_get_contents獲取管道輸出)
            //2 => array(`file`,`/tmp/err.txt`,`a`) //stderr(寫入到檔案)
        ), 
        $pipes, //管道(stdin/stdout/stderr)
        `/tmp`, //當前PHP程式的工作目錄
        array(`foo` => `bar`) //php.ini 配置 variables_order = "EGPCS" 其中E表示$_ENV,否則$_ENV輸出為空
    );
    //var_dump($pipes); //resource of type (stream)
    if(is_resource($proc)) {
        //stdin
        $stdin = serialize(array(`time` => time()));
        fwrite($pipes[0], $stdin); //把引數傳給指令碼task.php
        fclose($pipes[0]); //fclose關閉管道後proc_close才能退出子程式,否則會發生死鎖
        register_shutdown_function(function() use($pipes, $proc) { //事件驅動(指令碼結束事件),非同步回撥
            //stdout
            $stdout = stream_get_contents($pipes[1]);
            fclose($pipes[1]);
            //stderr
            $stderr = stream_get_contents($pipes[2]);
            fclose($pipes[2]);
            //exit code (返回程式的終止狀態碼,如果發生錯則返回-1)
            $status = proc_close($proc);
            $data = array(
                `stdout` => $stdout,
                `stderr` => $stderr,
                `status` => $status,
            );
            var_export($data); //echo json_encode($data);
        });
    }
}
foo();
//輸出:
array (
  `stdout` => `a:1:{s:4:"time";s:19:"2016-09-11 21:26:29";}`,
  `stderr` => ``,
  `status` => 0,
)

























謀膽並重


 







相關文章