PHP-Handbuch: Benennt eine Datei oder ein Verzeichnis um

Beschreibung

bool rename ( string $oldname , string $newname [, resource $context ] )

Versucht oldname in newname umzubenennen, wobei bei Bedarf zwischen Verzeichnissen verschoben wird. Existiert newname bereits, wird es überschrieben.

Parameter-Liste

oldname: Hinweis:
Der alte Name. Der Wrapper, der in oldname verwendet wird, muss mit dem Wrapper, der in newname verwendet wird, übereinstimmen.
newname: Der neue Name.
context: Hinweis: Die Kontext-Unterstützung gibt es seit PHP 5.0.0. Eine Beschreibung von Kontexten finden Sie unter Streams.

Rückgabewerte

Gibt bei Erfolg TRUE zurück. Im Fehlerfall wird FALSE zurückgegeben.

Changelog

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.

Beispiele

Beispiel #1 Beispiel mit rename


<?php
rename("/tmp/tmp_file.txt", "/home/user/login/docs/my_file.txt");
?>

Siehe auch

copy
unlink
move_uploaded_file