PHP Handbuch
Zurück |  | Weiter

# rename

(PHP 3, 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"); ?>`

> Anmerkung: In Versionen vor PHP 4.3.3 konnte rename() auf *nix-basierten Systemen nicht partitionsübergreifend verschieben.

> Anmerkung: Ab PHP 5.0.0 kann rename() mit manchen Url-Wrappern benutzt werden. Siehe Anhang M 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.

> Anmerkung: Der context Parameter ist ab PHP 5.0.0 verfügbar.

Siehe auch copy(), unlink() und move_uploaded_file().

Zurück | Zum Anfang | Weiter
realpath | Nach oben | rewind