proc_get_status 函数说明

函数名

proc_get_status

适用 PHP 版本

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

函数说明

proc_get_status() 函数用于获取由 proc_open() 启动的进程的当前状态信息。它返回一个关联数组，包含进程的运行状态、进程 ID、退出码等信息，方便开发者监控和控制子进程。

函数语法

array proc_get_status(resource $process)

参数

• $process：由 proc_open() 返回的资源类型，表示要查询状态的进程句柄。

返回值

返回一个关联数组，包含以下键值：

• command：执行的命令字符串。
• pid：进程 ID。
• running：布尔值，进程是否正在运行。
• signaled：布尔值，进程是否因信号终止（Windows 上始终为 false）。
• stopped：布尔值，进程是否被停止（Windows 上始终为 false）。
• exitcode：进程的退出码，如果进程还在运行则为 -1。
• termsig：终止进程的信号编号（Unix 系统）。
• stopsig：停止进程的信号编号（Unix 系统）。

示例

// 等待进程结束
sleep(6);

$status = proc_get_status($process);
echo "Is running after sleep: " . ($status['running'] ? "Yes" : "No") . "\n";

proc_close($process);

}

示例代码的说明

该示例代码通过 proc_open() 启动了一个执行“sleep 5”的子进程，然后调用 proc_get_status() 获取并输出子进程的 PID 和运行状态。随后程序等待 6 秒，再次获取进程状态确认子进程是否已结束，最后关闭进程句柄。示例演示了如何监控和查询子进程状态。