file_exists

(PHP 3, PHP 4, PHP 5)

file_exists -- ファイルまたはディレクトリが存在するかどうか調べる

説明

bool file_exists ( string filename )

filename で指定したファイルまたはディレクトリが存在すれば TRUE を返し、そうでなければ FALSE を返します。

Windows 上でネットワーク共有上のファイルを調べるには、 //computername/share/filename または \\computername\share\filename のように指定してください。

例 1. あるファイルが存在するかどうか調べる

<?php
$filename
= '/path/to/foo.txt';

if (
file_exists($filename)) {
    echo
"The file $filename exists";
} else {
    echo
"The file $filename does not exist";
}
?>

注意: この関数の結果は キャッシュされます。詳細は、clearstatcache() を参照してください。

ティップ: PHP 5.0.0 以降、この関数は、 何らかの URL ラッパーと組合せて使用することができます。 どのラッパーが stat() ファミリーをサポートしているか のリストについては、付録O を参照してください。

警告

この関数は セーフモード の制限のためファイルにアクセスできない場合 FALSE を返します。 しかし safe_mode_include_dir で指定されたディレクトリに存在する場合は include することができます。

注意: チェックは、実効ユーザではなく実ユーザの UID/GID で行います。

is_readable()is_writable()is_file() および file() も参照ください。