【PHP8.x】POSIX_SC_CLK_TCK定数の使い方

Copy
1<?php
2
3/**
4 * POSIX_SC_CLK_TCK の値を取得し、posix_kill を使用して子プロセスを管理するサンプルコード。
5 *
6 * このスクリプトは、新しい子プロセスをフォークし、親プロセスから子プロセスに
7 * シグナル (SIGTERM) を送信して終了させます。
8 * また、システムのクロックティック数を表す POSIX_SC_CLK_TCK 定数の値も表示します。
9 *
10 * 注意: このコードは Unix系システム (Linux, macOSなど) でのみ動作します。
11 * Windows環境では POSIX 拡張がサポートされていないため実行できません。
12 * また、`pcntl` および `posix` 拡張が有効になっている必要があります。
13 */
14function manageChildProcessWithPosix()
15{
16    // POSIX拡張が利用可能かチェック
17    if (!extension_loaded('posix')) {
18        echo "エラー: POSIX拡張がロードされていません。PHPの設定を確認してください。\n";
19        exit(1);
20    }
21    // PCNTL拡張が利用可能かチェック (プロセスフォークに必要)
22    if (!extension_loaded('pcntl')) {
23        echo "エラー: PCNTL拡張がロードされていません。PHPの設定を確認してください。\n";
24        exit(1);
25    }
26
27    // POSIX_SC_CLK_TCK 定数を使用してシステムクロックティック数を取得し表示
28    // この定数は、posix_sysconf() と組み合わせてシステムの様々な設定値を取得するために使用されます。
29    // クロックティック数 (CLK_TCK) は、システムが時間情報を計測する際の基本単位です。
30    $clk_tck = posix_sysconf(POSIX_SC_CLK_TCK);
31    if ($clk_tck === false) {
32        echo "エラー: POSIX_SC_CLK_TCK の値を取得できませんでした。\n";
33    } else {
34        echo "システムクロックティック数 (POSIX_SC_CLK_TCK): " . $clk_tck . " (1秒あたりのティック数)\n\n";
35    }
36
37    // プロセスをフォークする (子プロセスを作成)
38    $pid = pcntl_fork();
39
40    if ($pid === -1) {
41        // フォークに失敗した場合
42        echo "エラー: プロセスのフォークに失敗しました。\n";
43        exit(1);
44    } elseif ($pid) {
45        // 親プロセスの処理
46        $parentPid = getmypid();
47        echo "親プロセス (PID: {$parentPid}) が子プロセス (PID: {$pid}) を生成しました。\n";
48        echo "子プロセスが終了するのを3秒間待ちます...\n";
49        sleep(3); // 子プロセスが起動するのを待つ
50
51        // 子プロセスに SIGTERM シグナルを送信して終了を要求
52        // SIGTERM (終了シグナル) は、プロセスに対して優雅に終了するよう求める一般的な方法です。
53        echo "親プロセス (PID: {$parentPid}) が子プロセス (PID: {$pid}) に SIGTERM シグナルを送ります。\n";
54        $result = posix_kill($pid, SIGTERM);
55
56        if ($result) {
57            echo "シグナル送信成功。\n";
58        } else {
59            echo "エラー: シグナル送信失敗 (errno: " . posix_get_last_error() . ", errstr: " . posix_strerror(posix_get_last_error()) . ").\n";
60        }
61
62        // 子プロセスの終了を待機し、ゾンビプロセスになるのを防ぐ
63        pcntl_waitpid($pid, $status);
64        echo "子プロセス (PID: {$pid}) が終了しました。\n";
65    } else {
66        // 子プロセスの処理
67        $childPid = getmypid();
68        echo "子プロセス (PID: {$childPid}) が起動しました。\n";
69        echo "子プロセスはシグナルを待っています...\n";
70
71        // SIGTERM シグナル用のハンドラを設定
72        // SIGTERM を受け取ったら、メッセージを出力して終了します。
73        pcntl_signal(SIGTERM, function ($signo) use ($childPid) {
74            echo "子プロセス (PID: {$childPid}) がシグナル {$signo} を受け取りました。終了します。\n";
75            exit(0);
76        });
77
78        // 無限ループでシグナルイベントを処理
79        // pcntl_signal_dispatch() を定期的に呼び出すことで、シグナルハンドラが実行されます。
80        while (true) {
81            pcntl_signal_dispatch(); // ペンディング中のシグナルをディスパッチ
82            sleep(1); // 1秒ごとにチェック
83        }
84    }
85}
86
87// サンプル関数の実行
88manageChildProcessWithPosix();
89

このサンプルコードは、PHPで子プロセスを管理し、システムの基本的な情報を取得する方法を示しています。まず、POSIX_SC_CLK_TCKは、Unix系システムにおける1秒あたりのシステムクロックティック数を表す定数です。この定数自体には引数や戻り値はありませんが、posix_sysconf()関数と組み合わせて呼び出すことで、システムが時間を計測する際の基本単位であるクロックティック数（CLK_TCK）を取得できます。

次に、posix_killは、指定したプロセスID（PID）を持つプロセスに対し、特定のシグナルを送信するための関数です。第一引数にターゲットプロセスのPID、第二引数に送信したいシグナル番号（例: SIGTERMはプロセスに終了を要求するシグナル）を指定します。この関数は、シグナルの送信が成功した場合はtrueを、失敗した場合はfalseを返します。

サンプルコードでは、親プロセスがpcntl_fork()で子プロセスを生成した後、sleep()でしばらく待機し、その後posix_kill()を使用して子プロセスにSIGTERMシグナルを送信して終了させます。子プロセス側ではpcntl_signal()でSIGTERMシグナルを受け取った際の処理を設定し、シグナルを検出して終了します。このコードは、プロセス管理の基礎と、システム情報を取得する一例を示すものです。posixおよびpcntl拡張が有効なUnix系システムでのみ動作します。

Copy
1<?php
2
3/**
4 * システムおよび現在のユーザー情報を表示します。
5 *
6 * この関数は、POSIX拡張を利用してシステムクロックティックと
7 * 現在の実行ユーザーの詳細情報を取得し、表示します。
8 * システムエンジニアを目指す初心者向けに、基本的なシステム情報の
9 * 取得方法を示します。
10 */
11function displaySystemAndUserInformation(): void
12{
13    // POSIX_SC_CLK_TCK は、1秒あたりのシステムクロックティック数を示す定数です。
14    // 主にシステムパフォーマンスの計測やプロセス時間の計算などで利用されます。
15    echo "システムクロックティック数 (POSIX_SC_CLK_TCK): " . POSIX_SC_CLK_TCK . "\n\n";
16
17    // 現在のPHPスクリプトを実行しているユーザーのユーザーID (UID) を取得します。
18    $currentUserUid = posix_getuid();
19
20    // 取得したUIDを使って、そのユーザーの詳細情報を連想配列で取得します。
21    // この情報には、ユーザー名、ホームディレクトリ、シェルなどが含まれます。
22    $userInfo = posix_getpwuid($currentUserUid);
23
24    if ($userInfo !== false) {
25        echo "現在のユーザー情報:\n";
26        echo "  ユーザー名: " . ($userInfo['name'] ?? 'N/A') . "\n";
27        echo "  UID: " . ($userInfo['uid'] ?? 'N/A') . "\n";
28        echo "  GID: " . ($userInfo['gid'] ?? 'N/A') . "\n";
29        echo "  ホームディレクトリ: " . ($userInfo['dir'] ?? 'N/A') . "\n";
30        echo "  シェル: " . ($userInfo['shell'] ?? 'N/A') . "\n";
31        echo "  コメント (GECOS): " . ($userInfo['gecos'] ?? 'N/A') . "\n";
32    } else {
33        echo "エラー: 現在のユーザー情報を取得できませんでした。\n";
34        echo "POSIX拡張が有効になっているか、またはユーザーが存在するか確認してください。\n";
35    }
36}
37
38// 上記の関数を実行し、システムとユーザー情報を表示します。
39displaySystemAndUserInformation();
40

このPHPサンプルコードは、システムの基本的な情報と、スクリプトを実行している現在のユーザーの詳細情報を取得・表示する方法を、POSIX拡張機能を用いて示しています。システムエンジニアを目指す初心者の方々が、プログラムからシステム情報を扱うための第一歩として理解しやすいように構成されています。

まず、POSIX_SC_CLK_TCKは、1秒間に発生するシステムクロックティックの数を示す定数です。この値はシステムパフォーマンスの計測やプロセス時間の計算などで利用され、引数なしで直接その値が利用されます。

次に、posix_getuid()関数は、現在PHPスクリプトを実行しているユーザーのユーザーID（UID）を引数なしで取得します。この関数は、取得したUIDを整数値として返します。

さらに、このUIDを引数としてposix_getpwuid()関数に渡すと、ユーザー名、ホームディレクトリ、シェルパスなど、より詳細なユーザー情報を連想配列として取得できます。もしユーザー情報の取得に失敗した場合は、falseが返されます。サンプルコードでは、これらの情報が取得できた場合に整形して表示し、エラーの場合にはその旨を伝えています。このように、PHPのPOSIX拡張を利用することで、プログラムからOSレベルのユーザーやシステム情報を効率的に扱うことが可能です。