rename
(PHP 4, PHP 5, PHP 7, PHP 8)
rename — Benennt eine Datei oder ein Verzeichnis um
Beschreibung
$from, string $to, ?resource $context = null): bool
Versucht from in to
umzubenennen, wobei bei Bedarf zwischen Verzeichnissen verschoben wird.
Wird eine Datei umbenannt und to exisitiert
bereits, wird es überschrieben. Wird ein Verzeichnis umbenannt und
to exisitiert bereits, wird eine Warnung erzeugt.
Parameter-Liste
-
from -
Der alte Name.
Hinweis:
Der Wrapper, der in
fromverwendet wird, muss mit dem Wrapper, der intoverwendet wird, übereinstimmen. -
to -
Der neue Name.
Hinweis: Wenn unter Windows
tobereits existiert, muss er beschreibbar sein. Andernfalls schlägt rename() fehl und gibt einE_WARNINGaus. -
context -
Eine Stream-Kontext-Ressource.
Rückgabewerte
Gibt bei Erfolg true zurück. Bei einem Fehler wird false zurückgegeben.
Beispiele
Beispiel #1 Beispiel mit rename()
<?php
rename("/tmp/tmp_file.txt", "/home/user/login/docs/my_file.txt");
?>
Siehe auch
- copy() - Kopiert eine Datei
- unlink() - Löscht eine Datei
- move_uploaded_file() - Verschiebt eine hochgeladene Datei an einen neuen Ort
