file_exists

(PHP 4, PHP 5, PHP 7)

file_exists — Checks whether a file or directory exists

설명

bool file_exists ( string $filename )

Checks whether a file or directory exists.

인수

filename

Path to the file or directory.

On windows, use //computername/share/filename or \\computername\share\filename to check files on network shares.

반환값

Returns TRUE if the file or directory specified by filename exists; FALSE otherwise.

Note:
This function will return FALSE for symlinks pointing to non-existing files.

Warning

This function returns FALSE for files inaccessible due to safe mode restrictions. However these files still can be included if they are located in safe_mode_include_dir.

Note:
The check is done using the real UID/GID instead of the effective one.

Note: PHP의 정수형은 부호 있는 형식이고 많은 플랫폼이 32비트 정수를 사용하기에, 몇몇 파일시스템 함수는 2GB가 넘는 파일에 대해서 예측할 수 없는 결과를 반환합니다.

예제

Example #1 Testing whether a file exists


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

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

오류/예외

실패 시, E_WARNING이 발생합니다.

주의

Note: 이 함수의 결과는 캐시에 저장합니다. 자세한 설명은 clearstatcache()를 참고하십시오.

Tip

PHP 5.0.0부터 이 함수는 몇몇 URL 래퍼를 사용할 수 있습니다. 기능적으로 stat() 패밀리를 지원하는 래퍼 목록은 Supported Protocols and Wrappers를 참고하십시오.

참고

is_readable() - Tells whether a file exists and is readable
is_writable() - Tells whether the filename is writable
is_file() - Tells whether the filename is a regular file
file() - Reads entire file into an array