umask

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

umaskModificar a umask atual

Descrição

umask(?int $mask = null): int

umask() modifica o umask do PHP para a mask & 0777 e retorna o umask antigo. Quando o PHP está sendo usado como um módulo de servidor, o umask é restaurado ao final de cada requisição.

Parâmetros

mask

A nova máscara.

Valor Retornado

Se mask for null, umask() simplesmente retorna a umask atual senão a umask antiga é retornada.

Registro de Alterações

Versão Descrição
8.0.0 mask agora pode ser nulo.

Exemplos

Example #1 Exemplo da umask()

<?php
$umaskAntigo = umask(0);
chmod("/caminho/diretorio/arquivo.txt", 0755);
umask($umaskAntigo);

// Checking
if ($umaskAntigo != umask()) {
    die('Ocorreu um erro ao voltar para o umask antigo');
}
?>

Notas

Note:

Evite usar esta função em servidores web multithreaded. É melhor modificar as permissões do arquivo com chmod() depois de criar o arquivo. Usando umask() pode levar a comportamento inesperado de scripts executados concorrentemente e do próprio webserver porque todos eles usam a mesma umask.