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 pour ê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, référez-vous à 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 é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 distingué 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
"Entries:\n";

/* Correctly handling directory entries that may be considered falsy */
while (false !== ($entry = readdir($handle))) {
if (
$entry === '.' || $entry === '..') {
continue;
}
echo
"$entry\n";
}

closedir($handle);
}
?>

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

Entries:
base
en
fr
output.md
test.php

Voir aussi

  • readdir() - Lit une entrée du dossier
  • rewinddir() - Retourne à la première entrée du dossier
  • closedir() - Ferme le pointeur sur le dossier
  • dir() - Retourne une instance de la classe Directory
  • is_dir() - Indique si le fichier est un dossier
  • glob() - Recherche des chemins qui vérifient un masque
  • scandir() - Liste les fichiers et dossiers dans un dossier
↑↓ • • •