【PHP8.x】is_file関数の使い方

is_file関数は、指定されたパスが通常のファイルであるかどうかを確認する関数です。この関数は、引数として検証したいファイルのパスを受け取ります。もし指定されたパスが実際に存在する通常のファイルであれば、true（真）を返します。一方、指定されたパスが存在しない場合、ディレクトリである場合、あるいはシンボリックリンクだがリンク先が通常ファイルではない場合、またはその他の特殊なファイル（デバイスファイルなど）である場合には、false（偽）を返します。

この関数は、ファイル操作を行う前に、対象が通常のファイルであることを確認する際に非常に役立ちます。例えば、ファイルの読み書きを始める前に、指定されたパスがディレクトリではなく、実際に内容を持つファイルであることをチェックするために使用します。シンボリックリンクが指定された場合でも、そのリンク先が通常のファイルであればtrueを返しますので、実際のファイル実体を基準に判断できます。

ファイルが存在するかどうかだけを確認したい場合はfile_exists()関数を使用しますが、is_file()関数はさらにそれが「通常のファイル」であるかまでを厳密に判断します。これにより、意図しないディレクトリへの書き込みや、存在しないファイルへのアクセスといった予期せぬエラーを防ぎ、より堅牢なファイル処理ロジックを構築することが可能になります。ファイルシステムを扱うアプリケーション開発において、安全なファイル操作を実現するための基本的なツールの一つとして利用されます。

<?php
$filepath = 'path/to/your/file.txt';
$isFile = is_file($filepath);
?>

string $filename

• string $filename: 検査するファイルパスを指定する文字列

bool

指定されたファイルパスに、通常のファイルが存在するかどうかを判定します。ファイルが存在する場合は true を、存在しない場合やディレクトリである場合は false を返します。