PHP - glob

Třída

Kořen \ Bez třídy

Metoda - glob

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

Funkce glob() nalezne všechny soubory a adresáře, které odpovídají vzoru podle pravidel glob() funkce v libc. Pravidla jsou podobná jako pravidla v běžných shellech.

Pozor: Funkce funguje pouze v rámci souborového systému daného serveru, nelze s ní tedy vyhledávat soubory z jiných serverů.

Pozor: Funkce není dostupná na některých systémech, jako je starý Sun OS.

Pozor: příznak GLOB_BRACE není dostupný na některých ne-GNU systémech, jako je Solaris.

Procedurální

• function glob (string $pattern, int $flags = 0) : array

Parametry

Název	Datový typ	Výchozí hodnota	Popis
$pattern	string		Vzor pro hledání, u kterého se neprovede expanze tildy ani substituce parametru.
$flags	int	0	Přijímá příznaky: GLOB_MARK - Ke každému navrácenému adresáři přidá lomítko. GLOB_NOSORT - Navrácené soubory nejsou třízeny a jsou v pořadí, v jakém byly nalezeny. Pokud tento příznak nebyl použit, soubory a adresáře jsou seřazeny abecedně. GLOB_NOCHECK - Pokud nebyly nalezené žádné vyhovující soubory, bude navrácený vzor. GLOB_NOESCAPE - Zpětná lomítka neescapují speciální znaky. GLOB_BRACE - Rozbalí sekvence {a, b, c} tak, aby odpovídaly "a", "b" nebo "c". GLOB_ONLYDIR - Vrací pouze odpovídající adresáře. GLOB_ERR - Zastaví vyhledávání v případě chyb (např. nečitelných souborů a složek). Bez flagu jsou chyby ignorovány.

Návratové hodnoty

Vrací: array

Vrátí pole s odpovídajícími soubory či adresáři podle vzoru. Vrátí prázdné pole pokud nic neodpovídá nebo false pokud nastala chyba.

Příklady

Tato ukázka nalezne všechny soubory a adresáře, které odpovídají vzoru *.json.

<?php
foreach (glob("*.json") as $file) {
    echo "Našel jsem soubor '$file'";
}