(PHP 4 >= 4.3.0, PHP 5)
glob — パターンにマッチするパス名を探す
glob() 関数は libc の glob() 関数で使われるルールに基づいて pattern にマッチする全てのパス名を検索します。 ルールは、一般のシェルで使われるルールと似ています。
パターン。チルダの展開やパラメータ置換は行いません。
有効なフラグは次のとおりです。
マッチするファイル/ディレクトリを含む配列を返します。 マッチするファイルがなかった場合には空の配列、 そして失敗した場合には FALSE を返します。
注意: システムによっては、何もマッチしなかった場合とエラーが発生した場合を区別できないものもあります。
バージョン | 説明 |
---|---|
5.1.0 | GLOB_ERR が追加されました。 |
4.3.3 | PHP 4.3.3 以前では、GLOB_ONLYDIR が、 Windows やその他の GNU C ライブラリを使用しないシステムでも利用できるようになりました。 |
例1 glob() が opendir() と関連する関数群の代替策になるかを示す簡便な方法
<?php
foreach (glob("*.txt") as $filename) {
echo "$filename size " . filesize($filename) . "\n";
}
?>
上の例の出力は、たとえば 以下のようになります。
funclist.txt size 44686 funcsummary.txt size 267625 quickref.txt size 137820
注意: この関数では、 リモートファイル を 使用することはできません。これは、処理されるファイルがサーバの ファイルシステムによりアクセスできる必要があるためです。
注意: この関数が使用できないシステムも存在します (例: 昔の Sun OS など)。
注意: GLOB_BRACE フラグは、Solaris などの非 GNU システムでは動作しないことがあります。