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