【PHP8.x】proc_terminate関数の使い方

proc_terminate関数は、PHPのプロセス制御拡張モジュールで使用される関数で、popen()関数によって開始されたプロセスを終了させるために使用されます。popen()関数は、シェルコマンドを実行し、その入出力をファイルポインタとして扱うことができるようにする関数です。proc_terminate関数は、popen()関数によって返されたファイルポインタを引数として受け取り、そのファイルポインタに関連付けられたプロセスにSIGTERMシグナルを送信することで、プロセスの終了を試みます。

SIGTERMシグナルは、プロセスに対して正常な終了を要求するシグナルです。ほとんどのプロセスはSIGTERMシグナルを受け取ると、実行中の処理を中断し、後処理を行った後に終了します。しかし、プロセスがSIGTERMシグナルを無視したり、適切に処理しない場合、プロセスは終了しません。

proc_terminate関数は、プロセスがSIGTERMシグナルに応答しない場合でも、プロセスの終了を保証するものではありません。より強制的にプロセスを終了させる必要がある場合は、proc_close()関数を使用するか、オペレーティングシステムのコマンド（killコマンドなど）を使用する必要があります。proc_close()関数は、内部的にproc_terminate関数を呼び出し、その後ファイルポインタを閉じます。

この関数は、プロセスを安全に終了させるための第一歩として利用できます。特に、長時間実行される可能性のある外部プロセスを制御する場合に有効です。プロセスが終了しない場合は、より強力な手段を検討する必要があります。また、PHPスクリプトの実行ユーザーが、終了させようとしているプロセスを操作する権限を持っている必要があります。権限がない場合、proc_terminate関数は失敗する可能性があります。

proc_terminate(resource $process, int $signal = 15): bool

$process, int $signal = 15

• resource|open_resource $process: 終了させるプロセスを指定するリソース
• int $signal = 15: プロセスに送信するシグナルを指定する整数。デフォルトは15 (SIGTERM)

bool

指定されたプロセスを終了させることができるかどうかを示します。成功した場合はtrue、失敗した場合はfalseを返します。