無料CGI、PHPサイト(確認画面付きメールフォーム・メーリングリスト・メルマガ設置、逆アクセスランキング、画像カウンター等)PHPマニュアル by k-sky

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 は存在しません";
}
?>

注意

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

ヒント

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