rename

(PHP 4, PHP 5)

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.

Beispiel #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().