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 wird FALSE zurückgegeben.

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 Unterstützte Protokolle and 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().