Renomme un fichier ou un dossier

# rename

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

rename — Renomme un fichier ou un dossier

### Description

function 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 l'on renomme un fichier et que `to` existe, il sera écrasé. Si l'on renomme un répertoire et que `to` existe, cette fonction émet un avertissement.

### Liste de paramètres

`from`

  L'ancien nom.

  > Note:

  > L'enveloppe utilisée dans le paramètre `from` DOIT être la même que celle utilisée 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é

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