rename
(PHP 4, PHP 5, PECL zip:1.1.0-1.4.1)
rename — Benennt eine Datei oder ein Verzeichnis um
Beschreibung
bool rename
( string $oldname
, string $newname
[, resource $context
] )
Versucht oldname in newname umzubenennen.
Gibt bei Erfolg TRUE zurück, im Fehlerfall FALSE.
Example#1 Beispiel mit rename()
<?php
rename("/tmp/tmp_file.txt", "/home/user/login/docs/my_file.txt");
?>
Hinweis: In Versionen vor PHP 4.3.3 konnte rename() auf *nix-basierten Systemen nicht partitionsübergreifend verschieben.
Hinweis: Ab PHP 5.0.0 kann rename() mit manchen Url-Wrappern benutzt werden. Siehe List of Supported Protocols/Wrappers für eine Liste von Wrappern die rename() unterstützen. Wenn Wrapper verwendet werden, muss für oldname und newname der gleiche Wrapper benutzt werden.
Hinweis: Der context Parameter ist ab PHP 5.0.0 verfügbar.
Siehe auch copy(), unlink() und move_uploaded_file().