# pclose

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

pclose — Ferme un processus de pointeur de fichier

### Description

pclose(resource `$handle`): int

Ferme un processus de pointeur de fichier ouvert avec la fonction popen().

### Liste de paramètres

`handle`

  Le pointeur de fichier doit être valide, et avoir été ouvert correctement par popen().

### Valeurs de retour

Retourne le statut final du processus exécuté ou `-1` en cas d'echec.

> Note:

> Si PHP a été compilé avec l'option de configuration --enable-sigchild, la valeur retournée de cette fonction sera indéfinie.

### Exemples

Exemple #1 Exemple avec pclose()

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

### Notes

> Note: Unix seulement :

> pclose() est implémenté en interne en utilisant l'appel système `waitpid(3)`. Pour obtenir le code de statut réel de sortie, la fonction pcntl_wexitstatus() devrait être utilisée.

### Voir aussi

- popen() - Crée un processus de pointeur de fichier