pclose

Closes process file pointer

&reftitle.description; `int` `pclose` `resource` `handle`

Closes a file pointer to a pipe opened by `popen`.

&reftitle.parameters;

`handle`

- The file pointer must be valid, and must have been returned by a successful call to `popen`.

&reftitle.returnvalues;

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

¬e.sigchild;
&reftitle.examples;

### `pclose` example

    <?php
    $handle = popen('/bin/ls', 'r');
    pclose($handle);
    ?>

&reftitle.notes;

### Unix Only:

`pclose` is internally implemented using the `waitpid(3)` system call. To obtain the real exit status code the `pcntl_wexitstatus` function should be used.

&reftitle.seealso;

- `popen`