(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.
oldnameDer alte Name.
Hinweis:
Der Wrapper, der in
oldnameverwendet wird, muss mit dem Wrapper, der innewnameverwendet wird, übereinstimmen.
newnameDer neue Name.
contextHinweis: 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");
?>