proc_close

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

proc_close — Close pipes to a process opened by proc_open(), wait for it to terminate, and return its exit code

Description

function proc_close(resource $process): int

proc_close() is similar to pclose() except that it only works on processes opened by proc_open(). proc_close() waits for the process to terminate, and returns its exit code. Open pipes to that process are closed when this function is called, in order to avoid a deadlock - the child process may not be able to exit while the pipes are open.

Parameters

process: The proc_open() resource that will be closed.

Return Values

Returns the termination status of the process that was run. In case of an error, -1 is returned.

Note:
If PHP has been compiled with --enable-sigchild, the return value of this function is undefined.

Changelog

Version	Description
8.3.0	proc_close() now returns the correct exit code even after proc_get_status() was called first. Previously, `-1` was returned in that case.