(PHP 4, PHP 5, PHP 7)
rename — Renomme un fichier ou un dossier
$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.
oldnameL'ancien nom.
Note:
Le gestionnaire utilisé dans le paramètre
oldnameDOIT être le même que celui utilisé dansnewname.
newnameLe nouveau nom.
contextNote: Le support de contexte a été ajouté en PHP 5.0.0. Pour une description des contexts, référez-vous à Flux.
Cette fonction retourne TRUE en cas de succès ou FALSE si une erreur survient.
| Version | Description |
|---|---|
| 5.3.1 | rename() peut maintenant renommer des fichiers entre différents lecteurs Windows. |
| 5.0.0 | rename() peut aussi être utilisée avec certains gestionnaires d'URL. Reportez vous à Liste des protocoles et des gestionnaires supportés pour une liste des gestionnaires qui supportent rename(). |
| 4.3.3 | rename() peut maintenant renommer des fichiers entre différentes partitions Unix, si les permissions le permettent. Des Warnings peuvent être émis si la destination ne supporte pas les appels systèmes chown() ou chmod() sur les fichiers ; par exemple les systèmes de fichier FAT. |
Exemple #1 Exemple avec rename()
<?php
rename("/tmp/tmp_file.txt", "/home/user/login/docs/my_file.txt");
?>