Manuel PHP
Précédent |  | Suivant

# glob

(PHP 4 >= 4.3.0, PHP 5)

glob -- Recherche des chemins qui vérifient un masque

## Description

array glob ( string pattern [, int flags] )

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. Aucun remplacement de tilde (~) ou de paramètre n'est fait.

glob() retourne un tableau contenant les chemins et fichiers trouvés ou `FALSE` en cas d'erreur.

Valeurs autorisées pour flags :

- `GLOB_MARK`Ajoute un slash final à chaque élément retourné

- `GLOB_NOSORT` : Retourne les fichiers tant l'ordre d'apparence (pas de tri)

- `GLOB_NOCHECK` : Retourne le masque de recherche si aucun fichier n'a été trouvé

- `GLOB_NOESCAPE` : Ne protège aucun méta-caractère d'un anti-slash

- `GLOB_BRACE` : Remplace {a,b,c} par 'a', 'b' ou 'c'

- `GLOB_ONLYDIR` : Ne retourne que les dossiers qui vérifient le masque

  > Note : Avant PHP 4.3.3 `GLOB_ONLYDIR` n'était pas disponible sur Windows et les systèmes qui n'utilisent pas la bibliothèque GNU C.

- `GLOB_ERR` : Stop lors d'une erreur (comme des dossiers non lisibles), par défaut, les erreurs sont ignorées

  > Note : `GLOB_ERR` a été ajouté en PHP 5.1.

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

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

L'exemple ci-dessus va afficher :

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

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

Voir aussi opendir(), readdir(), closedir() et fnmatch().

Précédent | Sommaire | Suivant
fwrite | Niveau supérieur | is_dir