Change de dossier

Description

chdir(string $directory): bool

chdir() change le dossier courant de PHP en directory.

Liste de paramètres

directory: Le nouveau répertoire courant

Valeurs de retour

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

Erreurs / Exceptions

Émet une erreur de niveau E_WARNING si une erreur survient.

Exemples

Exemple #1 Exemple avec chdir()

<?php

// dossier courant
echo getcwd() . "\n";

chdir('public_html');

// dossier courant
echo getcwd() . "\n";

?>

Résultat de l'exemple ci-dessus est similaire à :

/home/vincent
/home/vincent/public_html

Notes

Attention

Si l'interpréteur PHP a été compilé avec ZTS d'activé (Zend Thread Safety), tous les changements du dossier courant réalisés via la fonction chdir() seront invisibles du système d'exploitation. Toutes les fonctions internes de PHP continueront à respecter le changement de dossier courant ; mais tous les appels aux fonctions des bibliothèques externes via FFI ne le respecteront pas. Il est possible de vérifier si la copie de PHP a été compilée avec l'activation de ZTS en utilisant php -i ou en utilisant la constante interne PHP_ZTS.

Voir aussi

getcwd() - Retourne le dossier de travail courant