# pclose

(PHP 4, PHP 5, PHP 7, PHP 8)

pclose — Cierra un proceso de un puntero a un fichero

### Descripción

pclose(resource `$handle`): int

Cierra un puntero a un fichero hacia una tubería abierta por popen().

### Parámetros

`handle`

  El puntero al fichero debe ser válido, y debe haber sido devuelto por una llamada exitosa a popen().

### Valores devueltos

Devuelve el estado de terminación del proceso que se estaba ejecutando. En caso de error, se devuelve `-1`.

> Nota:

> Si PHP se compiló con --enable-sigchild, el valor devuelto por esta función es indefinido.

### Ejemplos

Ejemplo #1 Ejemplo de pclose()

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

### Notas

> Nota: Solamente Unix:

> pclose() está internamente implementada usando la llamada al sistema de `waitpid(3)`. Para obtener el código de estado de salida real debería usarse la función pcntl_wexitstatus().

### Ver también

- popen() - Abre un proceso de un puntero a un fichero