rename

(PHP 4, PHP 5, PHP 7)

rename — Benennt eine Datei oder ein Verzeichnis um

Beschreibung

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

Versucht oldname in newname umzubenennen, wobei bei Bedarf zwischen Verzeichnissen verschoben wird. Wird eine Datei umbenannt, und newname exisitiert bereits, wird es überschrieben. Wird ein Verzeichnis umbenannt, und newname exisitiert bereits, wird eine Warnung erzeugt.

Parameter-Liste

oldname

Der alte Name.

Hinweis:

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.

Beispiele

Beispiel #1 Beispiel mit rename()

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

Siehe auch