array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.opendir.php', 1 => 'opendir', 2 => 'Ouvre un dossier, et récupère un pointeur dessus', ), 'up' => array ( 0 => 'ref.dir.php', 1 => 'Fonctions sur les dossiers', ), 'prev' => array ( 0 => 'function.getcwd.php', 1 => 'getcwd', ), 'next' => array ( 0 => 'function.readdir.php', 1 => 'readdir', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/dir/functions/opendir.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

opendir

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

opendir — Ouvre un dossier, et récupère un pointeur dessus

Description

opendir(string $directory, ?resource $context = null): resource|false

opendir() retourne un pointeur sur un dossier qui peut être utilisé avec les fonctions closedir(), readdir() et rewinddir().

Liste de paramètres

directory
Le chemin du dossier à ouvrir.
context
Pour une description du paramètre context, se reporter à la section les flux du manuel.

Valeurs de retour

Renvoie un gestionnaire de dossier en cas de succès ou false si une erreur survient

Erreurs / Exceptions

En cas d'échec, une alerte de type E_WARNING sera émise.

Ceci peut se produire si directory n'est pas un dossier valide, le dossier ne peut être ouvert pour des raisons de permissions, ou à cause d'erreurs liées au système de fichiers.

Historique

Version Description
8.0.0 context est désormais nullable.

Exemples

Exemple #1 Liste toutes les entrées d'un dossier, en ignorant les entrées spéciales . et ..

Du fait que les entrées de dossier et de fichier peuvent être des chaînes et s'évaluer comme "faux" (par exemple un dossier nommé "0"), et que readdir() retourne false lorsqu'il a lu toutes les entrées d'un dossier, il faut utiliser l'opérateur de comparaison === pour distinguer proprement une entrée de dossier dont le nom est "faux" d'une entrée de dossier qui a été lue et qui est false.

<?php
if ($handle = opendir('/path/to/files')) {
echo "Entrées :\n";

/* Gestion correcte des entrées de dossier pouvant être évaluées comme fausses */
while (false !== ($entry = readdir($handle))) {
if ($entry === '.' || $entry === '..') {
continue;
}
echo "$entry\n";
}

closedir($handle);
}
?>

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

Entrées :
base
en
fr
output.md
test.php

Voir aussi