PHP マニュアル: ファイル名がパターンにマッチするか調べる

bool fnmatch(string $pattern, string $filename, int $flags = 0)

fnmatchはfilename で指定された文字列が pattern で指定されたシェルワイルドカードにマッチするかどうかチェックします。

pattern

シェルのワイルドカードパターン。

filename

調べたい文字列。この機能は特にファイル名のマッチに便利ですが、通常の文字列に関しても使用できます。

一般的なユーザーにとって、シェルパターンやあるいは少なくとも '?'と'*'によるワイルドカードのほうが慣れていると思われます。そのため、 preg_match の代わりに fnmatch をフロントエンドの検索表現として使うことは、プログラマではないユーザーにとってより便利でしょう。

flags

flags の値は、以下のフラグを論理 OR (|) 演算子で連結した任意の組み合わせです。

**fnmatch で使えるフラグ**
`フラグ`	説明
`FNM_NOESCAPE`	バックスラッシュのエスケープを無効にする。
`FNM_PATHNAME`	文字列内のスラッシュは、指定したパターン内のスラッシュにのみマッチする。
`FNM_PERIOD`	文字列の先頭のピリオドは、指定したパターン内のピリオドにマッチしなければならない。
`FNM_CASEFOLD`	大文字小文字を区別しないマッチ。GNU 拡張の一部。

マッチした場合に true、それ以外の場合に false を返します。

例1 シェルのワイルドカードパターンによる色の名前のチェック


<?php
if (fnmatch("*gr[ae]y", $color)) {
  echo "some form of gray ...";
}
?>

警告

今のところ、この機能は POSIX に準拠していないシステムで利用できません (ただし、Windows では利用できます)。