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` теперь может принимать значение `null`.

Примеры

Пример #1 Пример использования функции umask()

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

// Проверка
if ($old != umask()) {
    die('При восстановлении umask произошла ошибка');
}
?>

Примечания

Замечание:
Избегайте вызова этой функции на многопоточных веб-серверах. Лучше изменить права созданного файла функцией chmod(). Функция umask() может вызвать неожиданное поведение одновременно работающих скриптов и самого веб-сервера, т. к. они все будут использовать одну и ту же umask.