file_exists

(PHP 4, PHP 5, PHP 7)

file_existsChecks whether a file or directory exists

Descrierea

file_exists ( string $filename ) : bool

Checks whether a file or directory exists.

Parametri

filename

Path to the file or directory.

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

Valorile întoarse

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

Notă:

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

Avertizare

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.

Notă:

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

Notă: Deoarece tipul întreg al PHP este cu semn și multe platforme utilizează întregi de 32 de biți, unele funcții ale sistemului de fișiere pot întoarce rezultate neașteptate pentru fișiere ce depășesc 2GB.

Exemple

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";
}
?>

Erori/Excepții

În cazul eșecului este emis un E_WARNING.

Note

Notă: Rezultatele acestei funcții sunt stocate în cache. Accesați clearstatcache() pentru mai multe detalii.

Sfat

Începând cu PHP 5.0.0 această funcție poate fi utilizată de asemenea cu unele învelișuri URL. Referiți-vă la Supported Protocols and Wrappers pentru a determina care învelișuri susțin familia de funcționalitate stat().

A se vedea și

  • 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