Fonction rename

La fonction rename renomme un fichier ou un répertoire. Le premier paramètre de la fonction accepte le nom actuel du fichier ou son chemin d'accès, le deuxième paramètre - le nouveau nom ou chemin. La fonction renvoie true en cas de succès et false en cas d'erreur.

Syntaxe

phprename(string $oldname, string $newname, resource $context = null): bool

Exemple

Renommons le fichier de 'old.txt' en 'new.txt' :

php<?php
  $res = rename('old.txt', 'new.txt');
  var_dump($res);
?>

Résultat de l'exécution du code :

phptrue

Exemple

Déplaçons un fichier vers un autre répertoire :

php<?php
  $res = rename('file.txt', 'newdir/file.txt');
  var_dump($res);
?>

Résultat de l'exécution du code :

phptrue

Exemple

Essayons de renommer un fichier inexistant :

php<?php
  $res = rename('nonexistent.txt', 'new.txt');
  var_dump($res);
?>

Résultat de l'exécution du code :

phpfalse

Exemple

Renommons un répertoire :

php<?php
  $res = rename('olddir', 'newdir');
  var_dump($res);
?>

Résultat de l'exécution du code :

phptrue

Voir aussi

  • la fonction copy,
    qui copie un fichier
  • la fonction unlink,
    qui supprime un fichier
  • la fonction move_uploaded_file,
    qui déplace un fichier téléchargé