Dans ce guide, nous discuterons de l'utilisation et de la syntaxe du fonction renommer() en PHP.
Qu'est-ce qu'une fonction rename() en PHP ?
Le Renommer() La fonction est une fonction PHP intégrée utilisée pour changer le nom du fichier ou du répertoire sans changer le contenu du fichier. Cette fonction prend l'ancien nom et le nouveau nom du fichier comme arguments nécessaires.
Syntaxe
Le format d'utilisation du Renommer() fonction en PHP est la suivante :
Renommer ( vieux , nouveau , contexte )
Le vieux et nouveau sont les paramètres obligatoires, les vieux spécifie le fichier que vous souhaitez modifier, nouveau spécifie le nouveau nom du fichier. Le contexte est un paramètre facultatif qui détermine le contexte de modification du nom de fichier.
Le fonction renommer() Retour Vrai en cas d'exécution réussie, sinon, il retourne FAUX. Le Renommer() file renvoie une erreur si le nouveau fichier existe déjà dans le même répertoire.
Comment utiliser la fonction rename() en PHP ?
Renommer le fichier via le fonction renommer() est facile, et les exemples suivants vous aideront dans ce cas.
Comment renommer un fichier en utilisant la fonction PHP rename()
Le code suivant va renommer un fichier test.php à un fichier.php :
Renommer ( 'test.php' , 'fichier.php' ) ;
?>
Si vous renommez un fichier qui existe déjà dans le même répertoire, il sera écrasé.
Exemple 1 - Comment renommer un fichier à l'aide de la fonction PHP rename()
L'exemple suivant renommera le test.php pour test2.php. En cas de réussite, le si déclaration sera imprimé sur la console, sinon, le déclaration d'autre sera affiché en sortie :
si ( Renommer ( 'C : \\ xampp \\ htdocs \\ test.php' , 'C : \\ xampp \\ htdocs \\ test2.php' ) )
{
écho ' Test.php renommé avec succès en test2.php' ;
}
autre {
écho 'Erreur lors du changement de nom du fichier' ;
}
?>
Note: En PHP, lors de la spécification des chemins de fichiers pour le Renommer() fonction (et d'autres opérations liées aux fichiers), il est important d'utiliser doubles barres obliques inverses (\\) au lieu d'un barre oblique simple (\) pour s'assurer que le chemin du fichier est interprété correctement, cela est dû au fait qu'une seule barre oblique inverse est traitée comme un caractère d'échappement en PHP.
Exemple 2 - Comment renommer un répertoire à l'aide de la fonction PHP rename()
Pour renommer un répertoire à l'aide de la Renommer() fonction, suivez le code ci-dessous :
$oldDirName = 'documents' ;$nouveauDirName = 'fichiers exemples' ;
si ( Renommer ( $oldDirName , $nouveauDirName ) ) {
écho 'Répertoire renommé avec succès !' ;
} autre {
écho 'Erreur lors du renommage du répertoire.' ;
}
Conclusion
La fonction rename() de PHP est un outil fiable pour renommer sans effort un fichier ou un répertoire tout en préservant son contenu. Sa syntaxe simple et ses capacités de gestion des erreurs en font un choix pratique pour les tâches de gestion de fichiers. En exploitant la puissance de Renommer(), Les développeurs PHP peuvent organiser et modifier efficacement les noms de fichiers ou de répertoires dans leurs projets.