unlink
(PHP 4, PHP 5, PHP 7, PHP 8)
unlink — Löscht eine Datei
Beschreibung
$filename
, ?resource $context
= null
): bool
Löscht filename
, ähnlich der UNIX-C-Funktion
unlink(). Bei einem Fehler wird ein Fehler der Stufe
E_WARNING
erzeugt.
Parameter-Liste
-
filename
-
Der Pfad zur Datei.
Wenn die Datei ein Symlink ist, wird der Symlink gelöscht. Unter Windows muss zum Löschen eines Symlinks auf ein Verzeichnis stattdessen rmdir() verwendet werden.
-
context
-
Eine Stream-Kontext-Ressource.
Rückgabewerte
Gibt bei Erfolg true
zurück. Bei einem Fehler wird false
zurückgegeben.
Changelog
Version | Beschreibung |
---|---|
7.3.0 | Unter Windows ist es nun möglich, Dateien mit verwendeten Handles per unlink() zu löschen, während dies zuvor fehlschlug. Es ist allerdings noch immer nicht möglich, die gelöschte Datei neu zu erzeugen, bevor alle Handles geschlossen wurden. |
Beispiele
Beispiel #1 Einfache Nutzung von unlink()
<?php
$fh = fopen('test.html', 'a');
fwrite($fh, '<h1>Hallo Welt!</h1>');
fclose($fh);
unlink('test.html');
?>