(PHP 4, PHP 5, PHP 7)
file_exists — ファイルまたはディレクトリが存在するかどうか調べる
$filename
) : boolファイルあるいはディレクトリが存在するかどうかを調べます。
filename
ファイルあるいはディレクトリへのパス。
Windows 上でネットワーク共有上のファイルを調べるには、 //computername/share/filename または \\computername\share\filename のように指定してください。
filename
で指定したファイルまたはディレクトリが存在すれば
TRUE
を返し、そうでなければ FALSE
を返します。
注意:
この関数は、シンボリックリンクの指す先のファイルが存在しない場合は
FALSE
を返します。
この関数は セーフモード
の制限のためファイルにアクセスできない場合 FALSE
を返します。
しかし safe_mode_include_dir
で指定されたディレクトリに存在する場合は
include
することができます。
注意:
チェックは、実効ユーザーではなく実ユーザーの UID/GID で行います。
注意: PHP の数値型は符号付整数であり、 多くのプラットフォームでは 32 ビットの整数を取るため、 ファイルシステム関数の中には 2GB より大きなファイルについては期待とは違う値を返すものがあります。
例1 あるファイルが存在するかどうか調べる
<?php
$filename = '/path/to/foo.txt';
if (file_exists($filename)) {
echo "$filename が存在します";
} else {
echo "$filename は存在しません";
}
?>
失敗したときは E_WARNING
が発生します。
注意: この関数の結果は キャッシュされます。詳細は、clearstatcache() を参照してください。
PHP 5.0.0 以降、この関数は、 何らかの URL ラッパーと組合せて使用することができます。 どのラッパーが stat() ファミリーをサポートしているかを調べるには サポートするプロトコル/ラッパー を参照してください。