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

    To Top