CHDIR

Syntaxe

Paramètres

Description

Cette fonction permet de changer de répertoire.

Remarques

• Il est préférable d'utiliser la constante «DIRECTORY_SEPARATOR» si vous souhaitez indiquez un chemin indépendant du système d'exploitation. Ainsi, cette constante aura un «\» sous le système d'exploitation Windows et «/» sous la distribution Linux.
• Objectif principal : La fonction chdir() en PHP est utilisée pour changer le répertoire de travail courant. Cela signifie qu'après son appel, toutes les opérations de fichiers suivantes, telles que la lecture, l'écriture ou la recherche de fichiers, seront effectuées dans le nouveau répertoire spécifié. Elle permet de modifier dynamiquement le contexte d'exécution d'un script.
• Paramètre unique : La fonction prend un seul paramètre, étant le chemin du répertoire vers lequel vous souhaitez changer. Ce chemin peut être soit absolu (complet) soit relatif au répertoire courant. Si le chemin est relatif, il sera interprété par rapport au répertoire actuel.
• Valeur de retour : chdir() retourne TRUE en cas de succès et FALSE en cas d'échec. Si l'échec se produit, vous pouvez utiliser error_get_last() ou getcwd() pour obtenir plus d'informations sur la cause de l'erreur (par exemple, un répertoire inexistant ou des permissions insuffisantes).
• Utilisation avec des chemins relatifs : Lorsque vous fournissez un chemin relatif, chdir() le résout par rapport au répertoire de travail actuel du script. Cela peut être pratique dans les cas où vous souhaitez naviguer dans une structure de répertoires sans connaître le chemin absolu exact.
• Équivalence avec chdir en ligne de commande : En PHP, chdir() fonctionne de manière similaire à la commande cd en ligne de commande (terminal ou interpréteur de commande). Cependant, contrairement à l'interpréteur de commande où cd change de répertoire pour toute la session, dans PHP, l'effet est limité à l'exécution du script en cours. Une fois le script terminé, le répertoire de travail revient à son état initial.
• Sécurité et permissions : L'utilisation de chdir() peut entraîner des problèmes de sécurité si elle est utilisée sans vérifier si l'utilisateur a les permissions appropriées pour accéder au répertoire cible. Par exemple, essayer de changer dans un répertoire sans droits d'accès peut entraîner un échec. Il est donc important de valider les chemins et les permissions avant d'utiliser cette fonction.
• Applications courantes : chdir() est souvent utilisée dans des scripts nécessitant une manipulation de fichiers dans un répertoire spécifique, comme les scripts de gestion de fichiers ou de traitement en lot. Elle est utile lorsqu'un script doit fonctionner sur plusieurs répertoires sans avoir à spécifier des chemins absolus à chaque opération.
• Changement de répertoire dans les processus PHP : Bien que chdir() change le répertoire de travail pour le script PHP en cours, cet effet est localisé à l'exécution du script. Cela signifie que si vous appelez plusieurs scripts à partir d'un script principal, chaque script peut définir son propre répertoire de travail sans affecter les autres, à moins que vous ne partagiez un processus ou un contexte d'exécution.

Exemple

Voici quelques exemples typiques de l'utilisation de cette fonction :

on obtiendra le résultat suivant si le répertoire «C:\WINDOWS» existe :

Références

PHP 4 - Guide du développeur, Edition First Interactive, Blake Schwendiman, 2002, ISBN: 2-84427-283-5, page 375