is_file

関数の概要

PHPの is_file 関数は、指定したパスが通常のファイルであるかどうかを確認するための関数です。ディレクトリや存在しないパスではなく、「通常のファイル」である場合に true を返します。ファイル操作を行う際に、対象がファイルであるかを事前にチェックするのに役立ちます。

パラメータの説明

  • string $filename
    チェック対象のパスを文字列で指定します。絶対パスでも相対パスでも構いません。

戻り値

指定したパスが通常のファイルであれば true を返し、それ以外（存在しないパス、ディレクトリ、シンボリックリンクなど）であれば false を返します。

使用例

基本的な使い方

<?php
$path = 'sample.txt';
if (is_file($path)) {
    echo 'ファイルです';
} else {
    echo 'ファイルではありません';
}
?>

指定したパスが通常ファイルかどうかを判定し、結果を表示しています。

ファイルが存在し、かつファイルかどうか確認する例

<?php
$filepath = '/var/www/html/example.txt';

if (file_exists($filepath) && is_file($filepath)) {
    echo 'ファイルが存在し、通常ファイルです。';
} else {
    echo 'ファイルが存在しないか、ファイルではありません。';
}
?>

単に is_file を使うだけでなく、存在確認と組み合わせて安全にチェックしています。

ディレクトリやシンボリックリンクかどうかの区別に使う例

<?php
$path = 'uploads';

if (is_file($path)) {
    echo '通常ファイルです';
} elseif (is_dir($path)) {
    echo 'ディレクトリです';
} else {
    echo 'ファイルでもディレクトリでもありません';
}
?>

ディレクトリやファイルを区別するために is_file と is_dir を使い分ける例です。

関連する関数

  • is_dir() – 指定したパスがディレクトリかどうかを調べる関数
  • file_exists() – 指定したファイルやディレクトリが存在するかを調べる関数
  • is_readable() – 指定したファイルやディレクトリが読み込み可能かどうかを調べる関数
  • is_writable() – 指定したファイルやディレクトリが書き込み可能かどうかを調べる関数

まとめ

is_file はファイル操作を行う際に、指定したパスが「通常ファイル」であるかを簡単にチェックできる非常に便利な関数です。ディレクトリや存在しないパスと区別できるので、コードの安全性や信頼性を高めるために積極的に活用しましょう。また、file_exists() や is_dir() と組み合わせて使うことで、より柔軟で堅牢なファイル判定処理が可能になります。

スポンサーリンク