rename

(PHP 3, PHP 4 , PHP 5)

rename -- Renomme un fichier ou un dossier

Description

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

rename() tente de renommer oldname en newname.

Cette fonction retourne TRUE en cas de succès, FALSE en cas d'échec.

Exemple 1. Exemple avec rename()

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

Note : Avant PHP 4.3.3, rename() ne pouvait pas renommer des fichiers entre différentes partitions Unix.

Note : Depuis PHP 5.0.0, rename() peut aussi être utilisée avec certains gestionnaires d'URL. Reportez vous à Annexe L pour une liste des gestionnaires qui supportent rename().

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

Note : Le paramètre context a été ajouté en PHP 5.0.0.;

Voir aussi copy(), unlink() et move_uploaded_file().