rename

(PHP 4, PHP 5)

renameRenomme un fichier ou un dossier

Description

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

Tente de renommer oldname en newname, en le déplaçant de répertoire si nécessaire. Si newname existe, il sera écrasé.

Liste de paramètres

oldname

Note:

L'ancien nom. 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 contextes, 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.
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.

Exemples

Exemple #1 Exemple avec rename()

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

Voir aussi

LoadingChargement en cours