file_exists: ファイルまたはディレクトリが存在するかどうか調べる (ファイルシステム 関数) - PHPプロ！マニュアル
PHPマニュアル
file_exists: ファイルまたはディレクトリが存在するかどうか調べる
file_exists
(PHP 4, PHP 5)
file_exists — ファイルまたはディレクトリが存在するかどうか調べる
説明
bool file_exists ( string $filename )
ファイルあるいはディレクトリが存在するかどうかを調べます。
パラメータ
- filename
-
ファイルあるいはディレクトリへのパス。
Windows 上でネットワーク共有上のファイルを調べるには、 //computername/share/filename または \\computername\share\filename のように指定してください。
返り値
filename で指定したファイルまたはディレクトリが存在すれば TRUE を返し、そうでなければ FALSE を返します。
注意:
この関数は、シンボリックリンクの指す先のファイルが存在しない場合は FALSE を返します。
警告
この関数は セーフモード の制限のためファイルにアクセスできない場合 FALSE を返します。 しかし safe_mode_include_dir で指定されたディレクトリに存在する場合は include することができます。
注意:
チェックは、実効ユーザではなく実ユーザの UID/GID で行います。
例
例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() ファミリーをサポートしているか のリストについては、サポートするプロトコル/ラッパー を参照してください。
参考
- is_readable() - ファイルが存在し、読み込み可能であるかどうかを知る
- is_writable() - ファイルが書き込み可能かどうかを調べる
- is_file() - 通常ファイルかどうかを調べる
- file() - ファイル全体を読み込んで配列に格納する
ページのトップへ
一つの目安として、ECサイトの購入情報など絶対に消えてはいけないものはDBに、カートなどの一時的に使用する情報や、ユーザに任意のタイミングで消去されても構わないものはセッションにと使い分けるといいでしょう。