(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. Existiert newname
bereits, wird es überschrieben.
oldname
Hinweis:
Der alte Name. 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");
?>