rename

(PHP 4, PHP 5, PHP 7)

rename — Renomme 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 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 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

copy() - Copie un fichier
unlink() - Efface un fichier
move_uploaded_file() - Déplace un fichier téléchargé

Rechercher une fonction PHP

Version en cache

05/11/2024 05:31:59 Cette version de la page est en cache (à la date du 05/11/2024 05:31:59) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.

Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-function.rename.html

L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.

Références

Manuel PHP : http://php.net

Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.

Table des matières Haut