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

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

Exemple

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

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

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

true

Exemple

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

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

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

true

Exemple

Essayons de renommer un fichier inexistant :

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

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

false

Exemple

Renommons un répertoire :

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

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

true

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é