file_exists

関数の概要

PHPの file_exists 関数は、指定したファイルやディレクトリがサーバー上に存在するかどうかを確認するための関数です。ファイル操作を行う際に、エラーを防ぐために事前にファイルの存在をチェックするときによく使われます。

パラメータの説明

  • filename：存在確認したいファイルやディレクトリのパス（文字列）。絶対パスまたは相対パスを指定します。

戻り値

file_exists は、指定されたファイルやディレクトリが存在する場合は true を返し、存在しない場合は false を返します。

使用例

基本的な使い方

<?php
$path = 'example.txt';

if (file_exists($path)) {
    echo 'ファイルが存在します。';
} else {
    echo 'ファイルが存在しません。';
}
?>

このコードは、カレントディレクトリにある example.txt というファイルの存在を確認し、結果を表示します。

ディレクトリの存在確認

<?php
$dir = 'uploads';

if (file_exists($dir)) {
    echo 'ディレクトリが存在します。';
} else {
    echo 'ディレクトリが存在しません。';
}
?>

ディレクトリの存在確認にも file_exists を使えます。ファイルだけでなくディレクトリも対象です。

画像ファイルの存在確認と表示

<?php
$imagePath = 'images/photo.jpg';

if (file_exists($imagePath)) {
    echo '<img src="' . $imagePath . '" alt="写真">';
} else {
    echo '画像が見つかりません。';
}
?>

画像ファイルの存在を確認して、あればHTMLのimgタグで表示する例です。ユーザーにエラー表示を出さずにスムーズに対応できます。

関連する関数

  • is_file：指定したパスがファイルかどうかを判定する
  • is_dir：指定したパスがディレクトリかどうかを判定する
  • file_get_contents：ファイルの内容を読み込む
  • unlink：ファイルを削除する

まとめ

file_exists はPHPでファイルやディレクトリの存在を簡単に確認できる便利な関数です。ファイル操作の前に使用することで、予期せぬエラーを防止し、安定した処理が可能になります。特にアップロードファイルの確認や設定ファイルのチェックなど、様々な場面で活用できるため、基本的な使い方を押さえておくと実務でも非常に役立ちます。

スポンサーリンク