PHPで指定したディレクトリ内のファイル名とディレクトリ名一覧取得

指定したディレクトリ内のファイル名を一覧で取得したい場合、PHPにはglob()という関数があります。

引数にはディレクトリ名を指定するのですが、ワイルドカード(*)が使えるのでディレクトリ内のファイル名やサブディレクトリ名を取得することができます。

ただ指定したディレクトリ内の一覧を取得するだけでなく、ちょっとした小細工も試してみました。

 

glob() は引数で指定したパターンに一致するパスの一覧を返す関数です。

引数に指定する内容で取得できるものが変わってきます。

PHP.net

PHPで指定したディレクトリ内のファイル名とディレクトリ名一覧取得

glob() の引数にディレクトリ名を入れると、そのディレクトリ内の全てのファイル名とディレクトリ名を返してくれます。

 

例えば、あるPHPファイルと同じ階層に「images」というディレクトリを作成し、画像を配置したとします。

その場合は次のように書きます。

$res = glob('images/*');

images/* の / (スラッシュ) は、ディレクトリの区切り文字です。

Windowsで言う￥と同じようなものです。

images/ と書くことで、imagesディレクトリの中という意味になります。

そこに、* をつけることで、「全て」という意味を加えで、「imagesディレクトリの中の全て」になります。

 

$res を var_dump() で出力すると次のようになります。

array(5) {
  [0]=>
  string(15) "images/neko.jpg"
  [1]=>
  string(17) "images/neko02.jpg"
  [2]=>
  string(17) "images/neko03.jpg"
  [3]=>
  string(17) "images/neko04.jpg"
  [4]=>
  string(10) "images/sub"
}

最後の要素の「images/sub」はディレクトリです。

全てのファイルとディレクトリが取得できました。

指定したディレクトリ内のディレクトリ名だけ取得

上の例ではファイル名とディレクトリ名を全て取得していました。

次はファイル名は無しでディレクトリ名だけ取得してみます。

 

やり方は簡単で、第2引数にオプションを設定できるのですが、そこに GLOB_ONLYDIR を設定するだけです。

$res = glob('./images/*', GLOB_ONLYDIR);
var_dump($res);

結果は次のようになります。

array(1) {
  [0]=>
  string(12) "./images/sub"
}

結果がディレクトリだけになりました。

拡張子を指定してファイル名取得

拡張子を指定して、マッチしたファイルのファイル名を取得する方法です。

例えば images ディレクトリ内の jpg のファイルだけを取得します。

$res = glob('./images/*.jpg');
var_dump($res);

指定する拡張子が複数ある場合は、オプションに GLOB_BRACE を使います。

GLOB_BRACE は複数の条件を指定でき、{a,b,c}のように書くと、条件aもしくは条件bもしくは条件cのようになります。

$res = glob('./images/{*.jpg,*.jpeg,*.png}', GLOB_BRACE);
var_dump($res);

上のように書けば、jpgとjpeg、pngの3つの拡張子のファイルを出力することができます。

 

今回は拡張子を指定しましたが、複数のディレクトリでも可能です。

$res = glob('{dir1/*,dir2/*}', GLOB_BRACE);

サブディレクトリも含め全てのファイル名を取得

指定したディレクトリの中のディレクトリ(サブディレクトリ)の中もまとめて一覧表示したい場合の方法です。

この場合、サブディレクトリの中に更にサブディレクトリがあるかもしれません。

そういう場合は繰り返して掘り下げていく感じですが、こういうのを再帰的って言うんでしたっけ？ぶっちゃけこういう言葉覚えるの苦手なんです(笑)

 

その掘り下げる方法に関してももっといい方法があるかもしれませんが、僕なりに作成してみたので参考にどうぞ。

function globAll($ptn) {
	// 指定されたディレクトリを出力
	echo $ptn . "<br />";

	// 指定されたディレクトリ内の一覧を取得
	$res = glob($ptn.'/*');

	// 一覧をループ
	foreach ($res as $f) {
		// is_file() を使ってファイルかどうかを判定
		if (is_file($f)) {
			// ファイルならそのまま出力
			echo $f . "<br />";
		} else {
			// ディレクトリの場合（ファイルでない場合）は再度globAll()を実行
			globAll($f);
		}
	}
}

// 最初にディレクトリを指定する
globAll('images');

面倒ですが、1つ関数（globAll）を作成して、結果の一覧の要素がファイルで無い場合は再度関数を実行するといった内容です。

とくにテストもしていないので自己責任でコピーしてください。

まとめ

ファイル名やディレクトリ名を一覧で取得するには glob() が便利です。

拡張子を指定する方法や、ディレクトリだけ取得する方法、サブディレクトリも掘り下げて一覧を取得する方法など紹介しましたが、他にも気になることがあればご質問ください。