# rename

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

rename — Renomme un fichier ou un dossier

### Description

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

Tente de renommer `from` en `to`, en le déplaçant de répertoire si nécessaire. Si vous renommez un fichier et que `to` existe, il sera écrasé. Si vous renommez un répertoire et que `to` existe, cette fonction émet un avertissement.

### Liste de paramètres

`from`

  L'ancien nom.

  > Note:

  > Le gestionnaire utilisé dans le paramètre `from` DOIT être le même que celui utilisé dans `to`.

`to`

  Le nouveau nom.

  > Note: Sur Windows, si `to` existe déjà, il doit pouvoir être écrit. Sinon rename() échoue et émet une `E_WARNING`.

`context`

  > Note: Une resource de contexte de flux.

### Valeurs de retour

Cette fonction retourne `true` en cas de succès ou `false` si une erreur survient.

### Exemples

Exemple #1 Exemple avec rename()

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

### Voir aussi

- copy() - Copie un fichier
- unlink() - Supprime un fichier
- move_uploaded_file() - Déplace un fichier téléchargé