file_exists

関数の概要

PHPの file_exists 関数は、指定したパスにファイルまたはディレクトリが存在するかどうかを確認するための関数です。ファイルシステム上での存在確認に非常に便利で、条件分岐などでよく使われます。WordPressのテーマやプラグイン開発でもよく利用される基本的な関数の一つです。

パラメータの説明

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

戻り値

対象のファイルまたはディレクトリが存在する場合は true を返し、存在しない場合は false を返します。

使用例

基本的な使い方

<?php
$path = 'sample.txt';
if (file_exists($path)) {
    echo "ファイルは存在します。";
} else {
    echo "ファイルは存在しません。";
}
?>

指定した「sample.txt」が存在するかどうかを判定し、結果を表示します。

ディレクトリの存在確認

<?php
$dir = '/var/www/html/wp-content/uploads';
if (file_exists($dir)) {
    echo "ディレクトリは存在します。";
} else {
    echo "ディレクトリは存在しません。";
}
?>

ファイルだけでなく、ディレクトリの存在も確認可能です。WordPressのアップロードフォルダなど、特定のフォルダがあるか確認するのに役立ちます。

ファイルの有無によって処理を分ける例

<?php
$theme_file = get_template_directory() . '/style.css';
if (file_exists($theme_file)) {
    include $theme_file;
    echo "テーマのスタイルシートを読み込みました。";
} else {
    echo "スタイルシートが見つかりません。";
}
?>

テーマフォルダ内のファイル存在をチェックしてから読み込む一例です。存在しないファイルを読み込むエラーを防げます。

関連する関数

  • is_file(): 対象が通常のファイルであるか確認する
  • is_dir(): 対象がディレクトリかどうかを判定する
  • filesize(): ファイルのサイズを取得する
  • unlink(): ファイルを削除する

まとめ

file_exists 関数はPHPでファイルやディレクトリの存在を簡単に確認できる便利な関数です。実務でもファイルの読み込み前チェックや、アップロード処理時のフォルダ確認などで頻繁に活用されます。適切に使用してエラーを防ぎ、より安全なファイル操作を実現しましょう。

スポンサーリンク