array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.rename.php', 1 => 'rename', 2 => 'Renomme un fichier ou un dossier', ), 'up' => array ( 0 => 'ref.filesystem.php', 1 => 'Fonctions sur les systèmes de fichiers', ), 'prev' => array ( 0 => 'function.realpath-cache-size.php', 1 => 'realpath_cache_size', ), 'next' => array ( 0 => 'function.rewind.php', 1 => 'rewind', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/filesystem/functions/rename.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

rename

(PHP 4, PHP 5, PHP 7, PHP 8)

rename — Renomme un fichier ou un dossier

Description

rename(string $from, string $to, ?resource $context = null): bool

Tente de renommer from en to, en le déplaçant de répertoire si nécessaire. Si l'on renomme un fichier et que to existe, il sera écrasé. Si l'on renomme un répertoire et que to existe, cette fonction émet un avertissement.

Liste de paramètres

from

L'ancien nom.

Note:

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

to

Le nouveau nom.

Note: Sur Windows, si to existe déjà, il doit pouvoir être écrit. Sinon rename() échoue et émet une E_WARNING.

context

Note: Une resource de contexte de flux.

Valeurs de retour

Cette fonction retourne true en cas de succès ou false si une erreur survient.

Exemples

Exemple #1 Exemple avec rename()

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

Voir aussi