rename

(PHP 4, PHP 5, PHP 7)

rename — Renomme un fichier ou un dossier

Description

rename ( string $oldname , string $newname [, resource $context ] ) : bool

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

Liste de paramètres

oldname

L'ancien nom.

Note:

Le gestionnaire utilisé dans le paramètre oldname DOIT être le même que celui utilisé dans newname.

newname

Le nouveau nom.

context

Note: Le support de contexte a été ajouté en PHP 5.0.0. Pour une description des contexts, référez-vous à Flux.

Valeurs de retour

Cette fonction retourne TRUE en cas de succès ou FALSE si une erreur survient.

Historique

Version Description
5.3.1 rename() peut maintenant renommer des fichiers entre différents lecteurs Windows.

Exemples

Exemple #1 Exemple avec rename()

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

Voir aussi