【PHP8.x】isFileメソッドの使い方

isFileメソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

isFileメソッドは、PHPのDirectoryIteratorクラスに属し、ディレクトリ内の項目を反復処理する際に、現在指している項目が通常のファイルであるかどうかを判定するメソッドです。このメソッドは、ディレクトリ、シンボリックリンク、デバイスファイルなどの他のファイルシステムのエントリタイプと、通常のファイルを区別するために使用されます。

具体的には、DirectoryIteratorオブジェクトが現在指すパスがファイルシステム上の通常のファイル(例えば、テキストファイル、画像ファイル、実行可能ファイルなど)である場合にtrueを返します。一方で、そのパスがディレクトリであったり、シンボリックリンク、存在しないパス、あるいはその他の特殊なファイルタイプである場合にはfalseを返します。

このメソッドは、ディレクトリ内の内容を処理する際に、ファイルだけを対象にしたい場合や、ファイルとディレクトリで異なる処理を実行したい場合に非常に有用です。例えば、特定のディレクトリ内にあるすべてのファイルのリストを作成したり、ファイルのサイズや更新日時などの情報を取得する前に、その項目が確実にファイルであることを確認するために利用できます。システムエンジニアを目指す方にとって、ファイルシステムの操作は基本的なスキルであり、本メソッドはその際によく利用される重要な機能の一つです。

構文(syntax)

1<?php
2
3$dir = new DirectoryIterator('.'); // 現在のディレクトリを対象とする
4foreach ($dir as $fileinfo) {
5    if ($fileinfo->isFile()) { // isFile() メソッドを呼び出し、通常のファイルかどうかをチェック
6        echo $fileinfo->getFilename() . " はファイルです。\n";
7    }
8}
9
10?>

引数(parameters)

引数なし

引数はありません

戻り値(return)

bool

現在のディレクトリ項目がファイルである場合に true を、それ以外の場合に false を返します。

【PHP8.x】isFileメソッドの使い方 | いっしー@Webエンジニア