PHPのumask()関数の使い方｜ファイルパーミッションの変更方法を解説

概要

PHPのumask()関数は、新しく作成されるファイルやディレクトリのデフォルトパーミッション（アクセス権）を制御するための関数です。

引数を指定して呼び出すと、PHPの現在のumaskを指定した値に変更し、変更前のumask値を返します。一方、引数なしで呼び出した場合は、現在設定されているumaskをそのまま取得できます。

なお、PHPがサーバーモジュールとして動作している場合、umaskは各リクエストの終了時に自動的に元の状態へ戻される点に注意してください。

umaskの仕組み

umaskとは「マスク」と呼ばれる仕組みで、新規作成されるファイルやディレクトリから取り除くパーミッションを指定するものです。例えばumask(0077)を設定すると、所有者以外のグループやその他のユーザーに対する読み込み・書き込み・実行権限がすべて無効化され、より安全な状態でファイルを作成できます。

構文

umask(mask)

パラメータ

• mask − 新しく設定するパーミッションを8進数で指定します。省略した場合は、現在のumask値のみを取得します。

戻り値

引数を指定せずに呼び出した場合は現在のumaskを返します。引数を指定して呼び出した場合は、変更前のumask値を返します。

使用例

<?php
// -rw-------
umask(0077);

// パーミッションを変更: -rw-r--r--
chmod('/new/one.txt', 0644);

echo "Access changed!";
?>

この例では、まずumask(0077)によって厳しいパーミッション設定を行い、その後chmod()を使って対象ファイルのアクセス権を明示的に変更しています。

出力

Access changed!