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

posix_kill関数の使い方について、初心者にもわかりやすく解説します。

作成日: 2025年09月11日更新日: 2025年10月05日

基本的な使い方

posix_kill関数は、指定したプロセスに対して特定のシグナル（信号）を送信する関数です。これは、実行中のプログラム（プロセス）に何らかの指示を伝えるための仕組みであり、主にUnix系システム（LinuxやmacOSなど）でプロセス間通信やプロセス制御に利用されます。

この関数は2つの引数を受け取ります。最初の引数にはシグナルを送りたいプロセスのID（PID）を整数値で指定し、2番目の引数には送りたいシグナルの番号またはPHPの事前定義定数（例: SIGTERM, SIGHUP, SIGKILLなど）を指定します。

シグナルはプロセスに特定のイベント発生を通知する役割を持ちます。例えば、SIGTERMシグナルはプロセスに「正常に終了してください」と終了を促します。一方、SIGHUPシグナルは通常、デーモンプロセスに対して「設定ファイルを再読み込みしてください」という指示に使われることがあります。特に注意が必要なのがSIGKILLシグナルで、これはプロセスを強制的に終了させる非常に強力なシグナルであり、プロセスはこのシグナルを無視したり捕捉したりすることはできません。

posix_kill関数は、シグナルの送信が成功した場合はtrueを、失敗した場合はfalseを返します。この関数を利用するには、シグナルを送信する側のプロセスが、ターゲットのプロセスに対して適切な権限を持っている必要があります。システム管理や、バックグラウンドで動作するデーモンプロセスの制御など、プロセスのライフサイクルを管理する場面で非常に有用な機能です。

構文(syntax)


1<?php
2$process_id = 12345; // シグナルを送信する対象のプロセスID
3$signal_number = SIGTERM; // 送信するシグナル番号（例: SIGTERMは終了シグナル）
4
5$success = posix_kill($process_id, $signal_number);
6?>

引数(parameters)

int $process_id, int $signal

int $process_id: シグナルを送信する対象のプロセスIDを指定する整数
int $signal: 送信するシグナルの種類を指定する整数

戻り値(return)

bool

指定されたシグナルをプロセスIDに送信する試みの成功または失敗を示します。trueが返された場合は成功、falseが返された場合は失敗です。

サンプルコード

PHP: posix_killでプロセスにシグナルを送る


1<?php
2
3/**
4 * posix_kill 関数の使用例。
5 * このスクリプトは、指定されたプロセスIDにシグナルを送信する方法を示します。
6 * シグナル0はプロセスを終了させず、プロセスの存在とアクセス権の確認に利用されます。
7 *
8 * この関数はPOSIX互換システム (Linux, macOSなど) でのみ動作します。
9 */
10
11// 1. このスクリプト自身のプロセスID (PID) を取得します。
12$currentPid = getmypid();
13echo "現在のPHPスクリプトのPID: {$currentPid}\n\n";
14
15// 2. 現在のプロセスにシグナル0を送信し、その存在とアクセス権を確認します。
16//    シグナル0はプロセスを終了させることなく、存在チェックに特化しています。
17echo "現在のプロセス (PID: {$currentPid}) の存在確認:\n";
18if (posix_kill($currentPid, 0)) {
19    echo "  成功: プロセスは存在し、アクセス可能です。\n";
20} else {
21    // 失敗した場合、posix_get_last_error() でエラーコードを取得し、
22    // posix_strerror() でそのエラーメッセージを取得できます。
23    $errorCode = posix_get_last_error();
24    $errorMessage = posix_strerror($errorCode);
25    echo "  失敗: プロセスの存在確認に失敗しました。エラーコード: {$errorCode} ({$errorMessage})\n";
26}
27
28echo "\n"; // 結果を見やすくするための改行
29
30// 3. 存在しないであろうプロセスIDにシグナル0を送信する例。
31//    これは通常、失敗するはずです。
32$nonExistentPid = 99999; // 通常、システムに存在しない高いPIDを使用します。
33echo "存在しない可能性のあるプロセス (PID: {$nonExistentPid}) の存在確認:\n";
34if (posix_kill($nonExistentPid, 0)) {
35    echo "  成功: プロセスは存在し、アクセス可能です。(これは通常予期されません)\n";
36} else {
37    $errorCode = posix_get_last_error();
38    $errorMessage = posix_strerror($errorCode);
39    echo "  失敗: プロセスは存在しないか、アクセスできません。エラーコード: {$errorCode} ({$errorMessage})\n";
40}
41

PHPのposix_kill関数は、指定されたプロセスIDを持つプロセスに対してシグナルを送信する機能を提供します。この関数は、特にシグナル番号に「0」を指定することで、プロセスを終了させることなく、そのプロセスがシステム上に存在し、現在のスクリプトからアクセス可能かどうかを確認する用途でよく利用されます。

引数$process_idには、シグナルを送信したいプロセスのID（PID）を整数で指定します。$signalには、送信するシグナルの番号を整数で指定しますが、プロセスの存在確認にはシグナル「0」を使用します。関数の戻り値は、シグナルが正常に送信（存在確認に成功）された場合はtrue、失敗した場合はfalseとなります。失敗した際には、posix_get_last_error()関数とposix_strerror()関数を組み合わせて使用することで、詳細なエラー情報を取得し、原因を特定できます。

サンプルコードでは、まずgetmypid()関数で現在実行中のPHPスクリプト自身のプロセスIDを取得し、そのIDに対してposix_kill関数でシグナル0を送信し、自身のプロセスの存在確認が成功する例を示しています。続いて、通常はシステムに存在しないであろう架空のプロセスIDにシグナル0を送信する例を提示し、その際に確認が失敗するケースとエラー情報の取得方法を解説しています。この関数は、LinuxやmacOSなどのPOSIX互換システムでのみ動作することに注意が必要です。

この関数はLinuxやmacOSのようなPOSIX準拠のOSでのみ利用可能で、Windows環境では動作しません。関数名に「kill」とありますが、第二引数に渡すシグナル番号によって挙動が変わります。サンプルコードで使われているシグナル 0 は、プロセスを終了させずに存在確認や権限チェックを行うための特殊な値です。実際にプロセスを終了させたい場合は、SIGTERM (通常は15) などのシグナルを指定します。また、自分以外のユーザーが実行しているプロセスにシグナルを送信するには、管理者（root）権限が必要な場合があります。権限不足はエラーの原因となるため注意してください。