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

Copy
1<?php
2
3/**
4 * umask 関数の使用例：現在の umask 値を取得し、新しい umask 値を設定し、元の値に戻す。
5 */
6
7// 現在の umask 値を取得
8$old_umask = umask();
9
10echo "現在の umask: " . decoct($old_umask) . "\n";
11
12// 新しい umask 値を設定 (例: 0022)
13$new_umask = 0022;
14umask($new_umask);
15
16echo "新しい umask を設定: " . decoct($new_umask) . "\n";
17
18// ファイル作成時のパーミッションを確認 (umask の影響を確認)
19touch("test_file.txt");
20$perms = fileperms("test_file.txt");
21$file_perms = substr(sprintf('%o', $perms), -4);
22
23echo "作成されたファイルのパーミッション: " . $file_perms . "\n";
24
25// umask を元の値に戻す
26umask($old_umask);
27
28echo "umask を元の値に戻しました: " . decoct($old_umask) . "\n";
29
30// 後始末: 作成したファイルを削除
31unlink("test_file.txt");
32
33?>

このPHPサンプルコードは、umask関数を使ったファイル作成時のパーミッション制御について解説しています。umask関数は、新規ファイルやディレクトリが作成される際のデフォルトパーミッションを設定するために使用します。

umask()のように引数なしで関数を呼び出すと、現在のumask値が整数で返されます。引数 $mask に整数値を指定すると、umask値を設定し、設定前のumask値を返します。$maskにnullを指定すると、umask値は変更されずに現在のumask値が返されます(PHP 8以降)。

サンプルコードでは、まず現在のumask値をumask()で取得し、decoct()関数を使って8進数表記に変換して表示しています。次に、umask(0022)で新しいumask値を設定します。この例では、0022という一般的な値を設定しています。

touch("test_file.txt")で新しいファイルを作成し、fileperms()関数でそのファイルのパーミッションを取得しています。取得したパーミッションを8進数で表示することで、umaskがファイル作成時のパーミッションにどのように影響するかを確認できます。

最後に、umask($old_umask)でumask値を元の値に戻しています。これは、スクリプトの実行後にシステムのデフォルト設定を変更しないための重要なステップです。unlink("test_file.txt")でテストファイルを削除して、後始末をしています。

この例を通して、umask関数がファイル作成時のセキュリティ設定にどのように影響するかを理解することができます。システムエンジニアを目指す上で、ファイルパーミッションの制御は重要な知識となります。

Copy
1<?php
2
3// 現在の umask 値を取得して表示します。
4$current_umask = umask();
5echo "現在の umask: " . decoct($current_umask) . "\n";
6
7// umask を 0 に設定します。これにより、新規ファイル作成時のパーミッションが最大になります。
8umask(0);
9
10// 設定後の umask 値を確認します。
11$new_umask = umask();
12echo "umask を 0 に設定しました。\n";
13
14// 新規ファイルを作成し、パーミッションを確認します。
15touch("test_file.txt");
16$perms = fileperms("test_file.txt");
17$permissions = substr(sprintf('%o', $perms), -4);
18
19echo "新規ファイルのパーミッション: " . $permissions . "\n";
20
21// umask を元の値に戻します。
22umask($current_umask);
23echo "umask を元の値に戻しました。\n";
24
25// スクリプト終了時の umask 値を表示します。
26$final_umask = umask();
27echo "スクリプト終了時の umask: " . decoct($final_umask) . "\n";
28?>

このPHPのサンプルコードは、umask()関数を使って、新規ファイル作成時のデフォルトのパーミッションを制御する方法を示しています。

umask()関数は、引数 $mask に指定された値を現在のumask値として設定します。$mask にnullが指定された場合は、現在のumask値を返します。この関数はint型の値を返します。

最初に、現在のumask値をumask()関数で取得し、decoct()関数を使って8進数表記に変換して表示しています。

次に、umask(0) を実行することで、umask値を0に設定しています。これにより、新しく作成されるファイルやディレクトリは、最大限のパーミッション（通常は0666または0777からumask値が引かれたもの）を持つようになります。設定後、再度umask()関数でumask値を確認しています。

touch("test_file.txt") で新規ファイルを作成し、fileperms()関数でファイルのパーミッションを取得しています。取得したパーミッションをsprintf('%o', $perms)で8進数表記に変換し、substr()関数で必要な部分を取り出して表示しています。

最後に、umask($current_umask) でumask値を最初に取得した値に戻し、スクリプト終了時のumask値を確認しています。これは、他のスクリプトやシステムに影響を与えないようにするための配慮です。

このサンプルコードを実行することで、umask()関数の挙動と、ファイルパーミッションに与える影響を理解することができます。