umask

(PHP 4, PHP 5, PHP 7, PHP 8)

umask — 現在の umask を変更する

説明

umask(?int $mask = null): int

umask() は PHP の umask を mask & 0777 にセットし、 元の umask 値を返します。 PHP がサーバー・モジュールとして動作中の場合、 各リクエストが終了するたびに umask は元の値に戻されます。

パラメータ

mask

新しい umask。

戻り値

mask が null の場合、 umask()は単に現在の umask 値を返します。 そうでない場合、元の umask 値を返します。

変更履歴

バージョン 説明
8.0.0 mask は、nullable になりました。

例

例1 umask() の例

<?php
$old 
= umask(0);
chmod("/path/some_dir/some_file.txt", 0755);
umask($old);

// チェック
if ($old != umask()) {
    die(
'An error occurred while changing back the umask');
}
?>

注意

注意:

マルチスレッドな Web サーバーでこの関数を使用することは避けてください。 ファイルを生成後、chmod() を使用してファイル権限を 変更するのがより良い方法です。全て同じ umask が使用されるので、 umask() の使用は、スクリプトを同時に実行する場合や Web サーバー自身の予期しない動作を引き起こす原因になる可能性があります。

関連キーワード:  umask, 変更, サーバー, 注意, 関数, int, 動作, しない, 予期, 自身