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

Copy
1<?php
2
3/**
4 * システムのメモリページサイズを取得して表示する関数。
5 * POSIX拡張が有効でない場合は、その旨をユーザーに伝えます。
6 *
7 * POSIX_SC_PAGESIZEは、システムのメモリ管理単位であるページサイズをバイト単位で示します。
8 * これはオペレーティングシステムがメモリを割り当てる際の最小単位です。
9 */
10function displaySystemPageSize(): void
11{
12    // POSIX拡張がPHPにロードされているかを確認
13    if (extension_loaded('posix')) {
14        // POSIX_SC_PAGESIZE 定数の値を取得し、表示
15        // この定数は、PHPのPOSIX拡張機能が提供するシステム設定値の一つです。
16        echo "System page size: " . POSIX_SC_PAGESIZE . " bytes\n";
17    } else {
18        // POSIX拡張がロードされていない場合のメッセージ
19        echo "Error: POSIX extension is not loaded.\n";
20        echo "To retrieve system page size, please enable the 'posix' extension in your php.ini.\n";
21    }
22}
23
24// 関数を実行してシステムページサイズを表示
25displaySystemPageSize();
26
27?>

このサンプルコードは、PHPでシステムのメモリページサイズを取得し表示する方法を示しています。POSIX_SC_PAGESIZEは、オペレーティングシステムがメモリを割り当てる際の最小単位である「ページサイズ」をバイト単位で表す定数です。この定数は引数を取らず、取得したページサイズは整数型（int）の値として返されます。

コードではまず、extension_loaded('posix')関数を使って、PHPのPOSIX拡張機能が有効になっているかを確認しています。POSIX拡張が有効な場合、POSIX_SC_PAGESIZEの値を直接参照し、「System page size: [値] bytes」という形式で出力します。これにより、実行環境のメモリページサイズを具体的に把握できます。

もしPOSIX拡張が有効でない場合、エラーメッセージを表示し、php.iniファイルで拡張機能を有効にする必要があることをユーザーに伝えます。この処理により、拡張機能が利用できない場合でも、適切な情報が提供されます。本サンプルは、PHPでシステムの低レベルな情報を安全に取得する基本的な手法を学ぶ上で役立ちます。

Copy
1<?php
2
3/**
4 * POSIXシステム情報とユーザー情報を取得して表示する関数。
5 * システムエンジニアを目指す初心者向けに、PHPのPOSIX拡張機能の基本的な利用方法を示します。
6 *
7 * この関数は、システムのページサイズと、現在のユーザーの詳細情報を取得して出力します。
8 *
9 * @return void
10 */
11function displayPosixAndUserInfo(): void
12{
13    // 最初に、POSIX拡張モジュールがPHPにロードされているか確認します。
14    // ロードされていない場合、関連する関数や定数は利用できません。
15    if (!extension_loaded('posix')) {
16        echo "エラー: POSIX 拡張モジュールがロードされていません。\n";
17        echo "php.ini で 'extension=posix' を有効にするか、必要なモジュールをインストールしてください。\n";
18        exit(1);
19    }
20
21    echo "--- POSIX システム情報 ---\n";
22
23    // システムのページサイズを取得します。
24    // リファレンス情報にある POSIX_SC_PAGESIZE は、システムのメモリページサイズを指す定数です。
25    // PHPでは通常、posix_sysconf() 関数に _SC_PAGESIZE 定数を渡して値を取得します。
26    // _SC_PAGESIZE 定数が定義されていない環境では、この部分は動作しません。
27    if (defined('_SC_PAGESIZE')) {
28        $pageSize = posix_sysconf(_SC_PAGESIZE);
29        if ($pageSize !== false) {
30            echo "システムのページサイズ (_SC_PAGESIZE): " . $pageSize . " バイト\n";
31        } else {
32            echo "システムのページサイズを取得できませんでした。(posix_sysconf(_SC_PAGESIZE) 失敗)\n";
33        }
34    } else {
35        echo "情報: _SC_PAGESIZE 定数が定義されていないため、ページサイズを取得できません。\n";
36    }
37
38    echo "\n--- ユーザー情報 ---\n";
39
40    // 現在このスクリプトを実行しているユーザーのUID（ユーザーID）を取得します。
41    $uid = posix_getuid();
42
43    if ($uid !== false) {
44        echo "現在のユーザーID (UID): " . $uid . "\n";
45
46        // 取得したUIDを使って、そのユーザーの詳細情報を取得します。
47        // posix_getpwuid() は、指定されたUIDを持つユーザーの詳細な情報を連想配列で返します。
48        $userInfo = posix_getpwuid($uid);
49
50        if ($userInfo !== false) {
51            echo "ユーザー詳細情報:\n";
52            echo "  ユーザー名 (name): " . ($userInfo['name'] ?? 'N/A') . "\n";
53            echo "  UID: " . ($userInfo['uid'] ?? 'N/A') . "\n";
54            echo "  GID: " . ($userInfo['gid'] ?? 'N/A') . "\n";
55            echo "  ホームディレクトリ (dir): " . ($userInfo['dir'] ?? 'N/A') . "\n";
56            echo "  シェル (shell): " . ($userInfo['shell'] ?? 'N/A') . "\n";
57            // その他の情報も userInfo 配列に含まれる場合がありますが、
58            // 初心者向けに主要なもののみ表示します。
59        } else {
60            echo "エラー: ユーザーID " . $uid . " の詳細情報を取得できませんでした。\n";
61        }
62    } else {
63        echo "エラー: 現在のユーザーIDを取得できませんでした。\n";
64    }
65}
66
67// 上記で定義した関数を実行し、情報を表示します。
68displayPosixAndUserInfo();

このサンプルコードは、PHPのPOSIX拡張機能を用いて、UNIX/Linux系のシステム情報と、現在スクリプトを実行しているユーザーの詳細情報を取得・表示する方法を、システムエンジニアを目指す初心者向けに示しています。

まず、PHPのPOSIX拡張モジュールがロードされているかを確認します。これは、関連する関数や定数が利用可能か事前にチェックするための重要なステップです。 次に、posix_sysconf()関数に_SC_PAGESIZE定数を渡すことで、システムのメモリページサイズを取得します。この_SC_PAGESIZEは、リファレンス情報にあるPOSIX_SC_PAGESIZEと同じく、システムのメモリ管理における基本的な単位（int）を指し、その値を整数で返します。 続いて、posix_getuid()関数を使用して、現在スクリプトを実行しているユーザーのユーザーID（UID）を取得します。この関数は、現在のユーザーを一意に識別する整数値（int）を戻り値として返します。 最後に、取得したUIDを引数としてposix_getpwuid()関数に渡します。この関数は、指定されたUIDに紐づくユーザーの詳細な情報（ユーザー名、ホームディレクトリ、シェルなど）を連想配列（array）として返します。これにより、システム上のユーザー情報をプログラムで取得し、表示することができます。 これらの機能は、システム管理やセキュリティ関連のスクリプト開発において基本的な知識となります。