Dateisystem
PHP Manual

rename

(PHP 4, PHP 5, PHP 7)

renameBenennt 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


Dateisystem
PHP Manual