glob

(PHP 4 >= 4.3.0, PHP 5, PHP 7)

glob — Recherche des chemins qui vérifient un masque

Description

array glob ( string $pattern [, int $flags = 0 ] )

glob() recherche tous les chemins qui vérifient le masque pattern, en suivant les règles utilisées par la fonction glob() de la libc, qui sont les mêmes que celles utilisées par le Shell en général.

Retour à la première page de Manuel PHP Table des matières Haut

Liste de paramètres

pattern

Le masque. Aucun remplacement de tilde (~) ou de paramètre n'est fait.

flags

Les drapeaux valides sont :

GLOB_MARK : Ajoute un slash final à chaque dossier retourné
GLOB_NOSORT : Retourne les fichiers dans l'ordre d'apparence (pas de tri). Lorsque ce drapeau n'est pas utilisé, les noms des champs sont triés alphabétiquement
GLOB_NOCHECK : Retourne le masque de recherche si aucun fichier n'a été trouvé
GLOB_NOESCAPE : Ne protège aucun métacaractère d'un antislash
GLOB_BRACE : Remplace {a,b,c} par 'a', 'b' ou 'c'
GLOB_ONLYDIR : Ne retourne que les dossiers qui vérifient le masque
GLOB_ERR : Stop lors d'une erreur (comme des dossiers non lisibles), par défaut, les erreurs sont ignorées.

Retour à la première page de Manuel PHP Table des matières Haut

Valeurs de retour

Retourne un tableau contenant les fichiers et dossiers correspondant au masque, un tableau vide s'il n'y a aucune correspondance, ou FALSE si une erreur survient.

Note:
Sous certains systèmes, il est impossible de distinguer un masque vide d'une erreur.

Retour à la première page de Manuel PHP Table des matières Haut

Historique

Version	Description
5.1.0	`GLOB_ERR` a été ajouté

Retour à la première page de Manuel PHP Table des matières Haut

Exemples

Exemple #1 Un moyen pratique pour remplacer opendir() par glob()


<?php
foreach (glob("*.txt") as $filename) {
    echo "$filename occupe " . filesize($filename) . "\n";
}
?>

L'exemple ci-dessus va afficher quelque chose de similaire à :

funclist.txt occupe 44686
funcsummary.txt occupe 267625
quickref.txt occupe 137820

Retour à la première page de Manuel PHP Table des matières Haut

Notes

Note: Cette fonction ne fonctionne pas avec les fichiers distants, car le fichier examiné doit être accessible sur le système de fichiers du serveur.

Note: Cette fonction n'est pas disponible sur quelques systèmes (e.g. vieux Sun OS).

Note: Le drapeau GLOB_BRACE n'est pas disponible sur quelques systèmes non GNU, comme Solaris.

Retour à la première page de Manuel PHP Table des matières Haut

Voir aussi

opendir() - Ouvre un dossier, et récupère un pointeur dessus
readdir() - Lit une entrée du dossier
closedir() - Ferme le pointeur sur le dossier
fnmatch() - Teste un nom de fichier au moyen d'un masque de recherche

Rechercher une fonction PHP

Version en cache

05/11/2024 20:42:04 Cette version de la page est en cache (à la date du 05/11/2024 20:42:04) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.

Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-function.glob.html

L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.

Références

Manuel PHP : http://php.net

Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.

Table des matières Haut