【PHP8.x】DirectoryIterator::getPerms()メソッドの使い方

Copy
1<?php
2
3/**
4 * 指定されたディレクトリ内の各ファイルおよびディレクトリのパーミッション（権限）を取得し、表示します。
5 *
6 * DirectoryIterator::getPerms() メソッドは、ファイルシステムのエントリのパーミッションを
7 * 整数値として返します。この整数値は、通常8進数表記（例: 0755）で表現されるパーミッションを
8 * 内部的に表すものです。
9 */
10function displayFilePermissions(string $directoryPath): void
11{
12    try {
13        // DirectoryIterator のインスタンスを作成します。
14        // これにより、指定されたディレクトリの内容をイテレート（繰り返し処理）できます。
15        $iterator = new DirectoryIterator($directoryPath);
16
17        echo "Directory permissions for: {$directoryPath}\n";
18        echo "------------------------------------------------\n";
19
20        // ディレクトリ内の各エントリ（ファイルやサブディレクトリ）をループ処理します。
21        foreach ($iterator as $fileInfo) {
22            // エントリの名前を取得します。
23            $name = $fileInfo->getFilename();
24
25            // エントリのパーミッションを整数値として取得します。
26            $permissionsInt = $fileInfo->getPerms();
27
28            // 取得した整数値を8進数文字列に変換して表示します。
29            // ファイルのパーミッションは通常8進数で表現されるため、decoct() 関数で変換するとより分かりやすくなります。
30            // 例: 16877 (int) は 040755 (octal) に相当します。
31            // 先頭の0はファイルタイプ（ここではディレクトリを示す040）とパーミッション（0755）を含みます。
32            $permissionsOctal = decoct($permissionsInt);
33
34            echo sprintf(
35                "File/Dir: %-25s Perms (int): %-10d Perms (octal): %s\n",
36                $name,
37                $permissionsInt,
38                $permissionsOctal
39            );
40        }
41    } catch (Exception $e) {
42        // ディレクトリが見つからない、またはアクセス権がない場合の例外処理です。
43        echo "Error: " . $e->getMessage() . "\n";
44    }
45}
46
47// このスクリプトが実行されている現在のディレクトリを対象とします。
48// 別のディレクトリを試す場合は、'./some_directory' のようにパスを変更してください。
49$targetDirectory = __DIR__;
50
51// 関数を呼び出してパーミッションを表示します。
52displayFilePermissions($targetDirectory);
53
54?>

PHPのDirectoryIterator::getPerms()メソッドは、ファイルシステム内の特定のファイルやディレクトリのパーミッション（権限）情報を取得するために使用されます。このメソッドはDirectoryIteratorクラスに属しており、このクラスを使うことで、指定されたディレクトリ内の各エントリ（ファイルやサブディレクトリ）を効率的に繰り返し処理できます。

getPerms()メソッドは引数を取りません。呼び出すと、対象エントリのパーミッションを整数値（int型）として返します。この整数値は、ファイルやディレクトリの読み書き実行権限などを内部的に表現したもので、一般的に「0755」や「0644」といった8進数形式で表されるパーミッションに相当します。サンプルコードでは、取得した整数値をdecoct()関数を用いて8進数文字列に変換し、より人間が理解しやすい形式で表示しています。例えば、「040755」のような8進数表現では、先頭の「040」はディレクトリであることを示し、「0755」が具体的なパーミッションを表します。

提供されたサンプルコードは、指定されたディレクトリ内のすべてのファイルとサブディレクトリについて、名前、取得されたパーミッションの整数値、そしてそれを変換した8進数形式のパーミッションを表示するものです。これにより、システムエンジニアの初心者は、ファイルやディレクトリの権限情報をプログラムでどのように取得し、確認できるかを学ぶことができます。

Copy
1<?php
2
3/**
4 * URLからクエリパラメータを取得し、HTML形式で表示する関数です。
5 * システムエンジニアを目指す初心者向けに、URLパラメータの取得方法と
6 * セキュリティ上の注意点（エスケープ処理）を説明しています。
7 *
8 * 例: このスクリプトを 'index.php' として保存し、
9 * ブラウザで 'http://localhost/index.php?name=Alice&age=30' のようにアクセスしてみてください。
10 */
11function getUrlParameters(): void
12{
13    echo "<h1>URLクエリパラメータの取得</h1>";
14
15    // $_GET はPHPのスーパーグローバル変数で、URLのクエリ文字列から
16    // パラメータを連想配列として取得します。
17    // 例: ?name=Alice&age=30 の場合、$_GET['name'] は 'Alice'、$_GET['age'] は '30' になります。
18
19    if (empty($_GET)) {
20        echo "<p>URLにクエリパラメータがありません。</p>";
21        echo "<p>例: このページのURLに <code>?key1=value1&key2=value2</code> のように追加してアクセスしてください。</p>";
22        // 現在のスクリプト名を取得し、ユーザーに例として提示
23        echo "<p>例: " . htmlspecialchars($_SERVER['SCRIPT_NAME']) . "?username=guest&id=123</p>";
24    } else {
25        echo "<p>以下のクエリパラメータが検出されました:</p>";
26        echo "<ul>";
27        foreach ($_GET as $key => $value) {
28            // htmlspecialchars() は、HTML特殊文字をエスケープして
29            // クロスサイトスクリプティング（XSS）攻撃を防ぐために重要です。
30            // ユーザーからの入力を直接HTMLに出力する際は必ず使用しましょう。
31            echo "<li><strong>" . htmlspecialchars($key) . "</strong>: " . htmlspecialchars($value) . "</li>";
32        }
33        echo "</ul>";
34
35        // 特定のパラメータが存在するか確認し、取得する例
36        // isset() を使ってパラメータが存在するかチェックすることは、
37        // 未定義のインデックスへのアクセスエラーを防ぐために重要です。
38        if (isset($_GET['username'])) {
39            echo "<p>個別のパラメータ 'username': " . htmlspecialchars($_GET['username']) . "</p>";
40        } else {
41            echo "<p>個別のパラメータ 'username' は見つかりませんでした。</p>";
42        }
43
44        if (isset($_GET['id'])) {
45            // 必要であれば、取得した値の型変換を行うことも一般的です。
46            $id = (int)$_GET['id'];
47            echo "<p>個別のパラメータ 'id' (整数型として取得): " . htmlspecialchars($id) . "</p>";
48        } else {
49            echo "<p>個別のパラメータ 'id' は見つかりませんでした。</p>";
50        }
51    }
52}
53
54// 関数を実行し、出力を行います。
55getUrlParameters();
56
57?>

このPHPサンプルコードは、WebページのURLに含まれるクエリパラメータを取得し、HTML形式で表示する方法を解説しています。システムエンジニアを目指す初心者の方に、Webアプリケーションでユーザーからの入力を受け取る基本的な仕組みと、その際に考慮すべきセキュリティ上の注意点を理解していただくことが目的です。

PHPでは、$_GETというスーパーグローバル変数が用意されており、URLの?以降に続くキー=値の形式で指定されたパラメータを、自動的に連想配列として格納します。例えば、?name=Alice&age=30というURLにアクセスした場合、$_GET['name']には'Alice'が、$_GET['age']には'30'がそれぞれ文字列としてセットされます。

コードではまず、$_GETが空かどうかを確認し、パラメータが存在しない場合はその旨を伝え、URLの例を提示します。パラメータが存在する場合は、foreachループを使ってすべてのキーと値を一覧表示します。ここで特に重要なのは、htmlspecialchars()関数を使って取得したパラメータをHTML出力前にエスケープしている点です。これは、クロスサイトスクリプティング（XSS）といった悪意のある攻撃を防ぐためのセキュリティ対策であり、ユーザーからの入力を直接HTMLに出力する際には必ず適用すべきです。

また、isset()関数を使用して特定のパラメータ（例: usernameやid）が存在するかどうかを確認することで、未定義のインデックスへのアクセスエラーを防ぎます。数値として扱いたいidのような値は、(int)キャストを使って整数型に変換する例も示されており、データの型を適切に扱うことの重要性も学べます。この関数を実行すると、現在のURLに応じたパラメータ情報がWebページに表示されます。