php8.5
Home/ Manual/ exec / functions/ proc_close

proc_close

PHP function Edit on GitHub ✎

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

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

Description

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.

Sigchild

Changelog

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

Source: reference/exec/functions/proc-close.xml · from the official PHP manual (php/doc-en)