(PHP 4, PHP 5, PHP 7)
rename — Benennt eine Datei oder ein Verzeichnis um
$oldname
, string $newname
[, resource $context
] )
Versucht oldname
in
newname
umzubenennen, wobei bei Bedarf zwischen
Verzeichnissen verschoben wird. Wird eine Datei umbenannt, und newname
exisitiert bereits, wird es überschrieben. Wird ein Verzeichnis umbenannt, und newname
exisitiert bereits, wird eine Warnung erzeugt.
oldname
Der alte Name.
Hinweis:
Der Wrapper, der in
oldname
verwendet wird, muss mit dem Wrapper, der innewname
verwendet wird, übereinstimmen.
newname
Der neue Name.
context
Hinweis: Die Kontext-Unterstützung gibt es seit PHP 5.0.0. Eine Beschreibung von Kontexten finden Sie unter Streams.
Gibt bei Erfolg TRUE
zurück. Im Fehlerfall wird FALSE
zurückgegeben.
Version | Beschreibung |
---|---|
5.3.1 | rename() kann nun unter Windows Dateien dateisystemübergreifend umbenennen. |
5.0.0 | rename() kann nun mit manchen URL-Wrappern benutzt werden. Siehe Unterstützte Protokolle und Wrapper für eine Liste von Wrappern die rename() unterstützen. |
4.3.3 | rename() ist nun möglicherweise auf *nix basierten Systemen in der Lage Dateien partitionsübergreifend umzubenennen, vorausgesetzt, dass entsprechende Berechtigungen vorliegen. Warnungen können erzeugt werden, wenn das Ziel-Dateisystem chown() oder chmod() Systemaufrufe für die Dateien nicht erlaubt - zum Beispiel, wenn das Ziel-Dateisystem ein FAT-Dateisystem ist. |
Beispiel #1 Beispiel mit rename()
<?php
rename("/tmp/tmp_file.txt", "/home/user/login/docs/my_file.txt");
?>