rename

(PHP 4, PHP 5, PHP 7, PHP 8)

rename — Benennt eine Datei oder ein Verzeichnis um

Beschreibung

rename(string $from, string $to, ?resource $context = null): bool

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

Parameter-Liste

from

Der alte Name.

Hinweis:

Der Wrapper, der in from verwendet wird, muss mit dem Wrapper, der in to verwendet wird, übereinstimmen.

to

Der neue Name.

Hinweis: Wenn unter Windows to bereits existiert, muss er beschreibbar sein. Andernfalls schlägt rename() fehl und gibt ein E_WARNING aus.

context

Eine Stream-Kontext-Ressource.

Rückgabewerte

Gibt bei Erfolg true zurück. Bei einem Fehler wird false zurückgegeben.

Beispiele

Beispiel #1 Beispiel mit rename()

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

Siehe auch