プロセスのファイルポインタをクローズする

# pclose

(PHP 4, PHP 5, PHP 7)

pclose — プロセスのファイルポインタをクローズする

### 説明

pclose ( resource `$handle` ) : int

popen() でオープンしたパイプへの ファイルポインタをクローズします。

### パラメータ

`handle`

  ファイルポインタは有効なものでなければならず、また popen() で正常にオープンされたものである必要があります。

### 返り値

実行していたプロセスの終了ステータスを返します。 エラーが発生した場合は -1 を返します。

> 注意:

> PHP のコンパイル時に --enable-sigchild を指定した場合は、この関数の返り値は未定義となります。

### 例

例1 pclose() の例

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

### 注意

> 注意: Unix のみ

> pclose() の内部的な実装は、 waitpid(3) システムコールを使っています。 実際の終了ステータスを知るには、pcntl_wexitstatus() 関数を使わなければなりません。

### 参考

- popen() - プロセスへのファイルポインタをオープンする