proc_close

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

proc_close关闭由 proc_open() 打开的进程并返回该进程的退出代码

说明

proc_close(resource $process): int

proc_close()pclose() 类似,区别在于它只对由 proc_open() 打开的进程起作用。 proc_close() 等待进程终止,并返回其退出代码。 当调用此函数时,该进程的打开管道将被关闭,以避免死锁——子进程可能无法在管道打开时退出。

参数

process

将要关闭的 proc_open() resource

返回值

返回运行的进程的终止状态。 如果发生错误,则返回 -1

注意:

如果 PHP 使用 --enable-sigchild 编译,则此函数的返回值未定义。

添加笔记

用户贡献笔记 5 笔记

13
oohay251 at yahoo dot com
18 年前
从各种互联网帖子和最近的经验来看,我发现你不能依赖 proc_close 返回子进程的准确返回代码。 返回代码还取决于你是否从 stdout/stderr 管道读取,就像我的示例所示。 我通过将退出代码写入额外的文件描述符来解决这个问题。

<?
$descriptorspec = array(
0 => array('pipe', 'r'), // stdin 是子进程将从中读取的管道
1 => array('pipe', 'w'), // stdout 是子进程将写入的管道
2 => array('pipe', 'w'), // stderr 是子进程将写入的管道
);
$proc = @proc_open("/bin/ls -l /etc/passwd", $descriptorspec, $pipes);
fclose($pipes[0]);
$output = array();
while (!feof($pipes[1])) array_push($output, rtrim(fgets($pipes[1],1024),"\n"));
fclose($pipes[1]);
while (!feof($pipes[2])) array_push($output, rtrim(fgets($pipes[2],1024),"\n"));
fclose($pipes[2]);
$exit=proc_close($proc);
print_r($output);
echo "exitcode $exit\n\n";

$descriptorspec = array(
0 => array('pipe', 'r'), // stdin 是子进程将从中读取的管道
1 => array('pipe', 'w'), // stdout 是子进程将写入的管道
2 => array('pipe', 'w'), // stderr 是子进程将写入的管道
);
$proc = @proc_open("/bin/ls -l /etc/passwd", $descriptorspec, $pipes);
fclose($pipes[0]);
fclose($pipes[1]);
fclose($pipes[2]);
$exit=proc_close($proc);
echo "exitcode $exit\n\n";

$descriptorspec = array(
0 => array('pipe', 'r'), // stdin 是子进程将从中读取的管道
1 => array('pipe', 'w'), // stdout 是子进程将写入的管道
2 => array('pipe', 'w'), // stderr 是子进程将写入的管道
3 => array('pipe', 'w'), // stderr 是子进程将写入的管道
);
$proc = @proc_open("/bin/ls -l /etc/passwd;echo $? >&3", $descriptorspec, $pipes);
fclose($pipes[0]);
$output = array();
// 注释下一行以获取正确的 exicode
while (!feof($pipes[1])) array_push($output, rtrim(fgets($pipes[1],1024),"\n"));
fclose($pipes[1]);
while (!feof($pipes[2])) array_push($output, rtrim(fgets($pipes[2],1024),"\n"));
fclose($pipes[2]);
if (!feof($pipes[3])) $output['exitcode']=rtrim(fgets($pipes[3],5),"\n");
fclose($pipes[3]);
proc_close($proc);
print_r($output);
?>

在我的系统上输出

数组
(
[0] => -rw-r--r-- 1 root root 1460 2005-09-02 09:52 /etc/passwd
[1] =>
[2] =>
)
exitcode -1

exitcode 1

数组
(
[0] => -rw-r--r-- 1 root root 1460 2005-09-02 09:52 /etc/passwd
[1] =>
[2] =>
[exitcode] => 0
)
9
Uwe Ohse
8 年前
关于:"返回运行的进程的终止状态。 如果发生错误,则返回 -1."

这充其量是误导。 它返回
* -1 出错时,
* WEXITSTATUS(status) 如果 WIFEXITED(status) 为真,或者
* status 如果 WIFEXITED(status) 为假,
其中 status 是 waitpid() 的 status 参数。

这使得无法区分相对正常的退出或信号终止,并将 proc_close 返回代码的值降低到二进制值(正常 / 有问题)。

这可以在 ext/standard/proc_open.c (PHP 5.4.44, 5.6.12) 中的 proc_open_rsrc_dtor() 中看到。
1
ashnazg at php dot net
16 年前
似乎如果你在编译 PHP 时配置了 --enable-sigchild(从我的阅读来看,这是使用 Oracle 内容的必要条件),那么 proc_close() 的返回代码不可信。

使用 proc_open 的示例 1998 年的代码在我的 PHP4 (4.4.7) 和 PHP5 (5.2.4) 版本上,返回代码始终为 "-1"。 这是我通过运行其他 shell 命令(无论成功还是失败)都可能引起的唯一返回代码。

除了这个旧的错误报告外,我在任何地方都没有看到这个警告——http://bugs.php.net/bug.php?id=29123
1
sergey1369 at narod dot ru
20 年前
在 PHP/4.3.3RC2 下,在两个进程的情况下
这些函数可能会挂起。 解决方法是不使用
proc_close,或者在所有 fclose 完成后将其放在后面。

例如,这段代码会挂起。

$ph1 = proc_open("cat",
array(0=>array("pipe","r"),1=>array("pipe","w")),
$pipes1);
$ph2 = proc_open("cat",
array(0=>array("pipe","r"),1=>array("pipe","w")),
$pipes2);

fclose($pipes1[0]); fclose($pipes1[1]); proc_close($ph1);
fclose($pipes2[0]); fclose($pipes2[1]); proc_close($ph2);

这段代码对我有用

$ph1 = proc_open("cat",
array(0=>array("pipe","r"),1=>array("pipe","w")),
$pipes1);
$ph2 = proc_open("cat",
array(0=>array("pipe","r"),1=>array("pipe","w")),
$pipes2);

fclose($pipes1[0]); fclose($pipes1[1]);
fclose($pipes2[0]); fclose($pipes2[1]);
proc_close($ph1); proc_close($ph2);
0
morrisdavidd at gmail dot com
16 年前
考虑以下伪代码

$SOME_PROCESS = proc_open(/* 这里有一些内容 */);
...
$status = proc_get_status($SOME_PROCESS);
...
$exitCode = proc_close($SOME_PROCESS);

如果外部程序在调用 proc_get_status 之前已自行退出,则 $exitCode == -1

因此,请考虑使用
$actualExitCode = ($status["running"] ? $exitCode : $status["exitcode"] );
To Top