# 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

- copy() - Kopiert eine Datei
- unlink() - Löscht eine Datei
- move_uploaded_file() - Verschiebt eine hochgeladene Datei an einen neuen Ort

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open