umask

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

umaskChanges the current umask

Beschreibung

umask(?int $mask = null): int

umask() setzt die umask von PHP auf mask & 0777 und gibt die alte umask zurück. Wird PHP als Servermodul benutzt, wird die umask wiederhergestellt, wenn die jeweilige Anfrage beendet ist.

Parameter-Liste

mask

Die neue umask.

Rückgabewerte

Wenn mask null ist, gibt umask() einfach die aktuelle umask zurück, ansonsten wird die alte umask zurückgegeben.

Changelog

Version Beschreibung
8.0.0 mask ist jetzt nullbar.

Beispiele

Beispiel #1 umask()-Beispiel

<?php
$old
= umask(0);
chmod("/pfad/ein_verzeichnis/eine_datei.txt", 0755);
umask($old);

// Prüfung
if ($old != umask()) {
die(
'Ein Fehler trat beim Wiederherstellen der umask auf');
}
?>

Anmerkungen

Hinweis:

Sie sollten diese Funktion nicht in Multithreaded-Webservern nutzen. Der bessere Weg ist, die Dateiberechtigungen mit chmod() zu ändern nachdem die Datei erstellt wurde. Die Nutzung von umask() kann zu unerwartetem Verhalten von gleichzeitig ausgeführten Skripten und des Webservers führen, weil die gleiche umask genutzt wird.