glob

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

    glob — Recherche des chemins qui vérifient un masque

    Description

    glob(string$pattern, int$flags = 0): array|false

    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.

    Liste de paramètres

    pattern

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

    Caractères spéciaux :

    • * - Associe zéro ou plus de caractères.
    • ? - Associe exactement un caractère (n'importe quel caractère).
    • [...] - Associe un caractère d'un ensemble de caractères. Si le premier caractère est !, associe n'importe quel caractères pas dans cet ensemble.
    • \ - Échappe le caractère suivant, sauf quand le drapeau GLOB_NOESCAPE est utilisé.
    flags

    Les drapeaux valides sont :

    GLOB_BRACE (int)
    Étend {a,b,c} pour correspondre à 'a', 'b' ou 'c'

    Note: GLOB_BRACE n'est pas disponible sur certains systèmes non-GNU, comme Solaris ou Alpine Linux.

    GLOB_ERR (int)
    Arrête en cas d'erreurs de lecture (comme les répertoires illisibles), par défaut, les erreurs sont ignorées.
    GLOB_ONLYDIR (int)
    Retourne uniquement les entrées de répertoire qui correspondent au motif.
    GLOB_MARK (int)
    Ajoute une barre oblique (un antislash sur Windows) à chaque répertoire retourné.
    GLOB_NOSORT (int)
    Renvoie les fichiers tels qu'ils apparaissent dans le répertoire (sans tri). Lorsque ce drapeau n'est pas utilisé, les noms de chemin sont triés par ordre alphabétique.
    GLOB_NOCHECK (int)
    Renvoie le motif de recherche s'il n'y a pas de fichiers correspondants.
    GLOB_NOESCAPE (int)
    Les antislash ne mettent pas en échappement les métacaractères.
    GLOB_AVAILABLE_FLAGS (int)
    Tous les drapeaux GLOB_* combinés. Équivalent à 0 | GLOB_BRACE | GLOB_MARK | GLOB_NOSORT | GLOB_NOCHECK | GLOB_NOESCAPE | GLOB_ERR | GLOB_ONLYDIR

    Note: Le drapeau GLOB_BRACE n'est pas disponible sur certains systèmes non GNU, tel que Solaris ou Alpine Linux.

    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.

    Exemples

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

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

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

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

    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).

    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
    To Top