Funkcje Systemu plików
PHP Manual

file_exists

(PHP 4, PHP 5)

file_existsSprawdza czy plik lub katalog istnieje

Opis

bool file_exists ( string $nazwa_pliku )

Sprawdza czy plik lub katalog istnieje.

Parametry

nazwa_pliku

Ścieżka do pliku lub katalogu.

Pod Windows, użyj //nazwa_komputera/udział/nazwa_pliku lub \\nazwa_komputera\udział\nazwa_pliku aby sprawdzić pliki dla sieciowych udziałów.

Zwracane wartości

Zwraca TRUE jeśli plik lub katalog określony w nazwa_pliku istnieje; FALSE w przeciwnym wypadku.

Informacja:

Ta funkcja zwróci FALSE dla linków symbolicznych wskazujących na nie istniejące pliki.

Ostrzeżenie

Funkcja zwraca FALSE dla plików niedostępnych z powodu restrykcji trybu bezpiecznego. Jednak te pliki ciągle mogą być inkludowane jeśli znajdują się w safe_mode_include_dir.

Informacja:

Sprawdzanie dokonywane jest na prawdziwych UID/GID, a nie efektywnych.

Informacja: Because PHP's integer type is signed and many platforms use 32bit integers, some filesystem functions may return unexpected results for files which are larger than 2GB.

Przykłady

Przykład #1 Sprawdzanie czy plik istnieje

<?php
$nazwa_pliku 
'/sciezka/do/pliku.txt';

if (
file_exists($nazwa_pliku)) {
    echo 
"Plik $nazwa_pliku istnieje";
} else {
    echo 
"Plik $nazwa_pliku nie istnieje";
}
?>

Błędy/Wyjątki

W przypadku niepowodzenia jest emitowany E_WARNING.

Notatki

Informacja: Wyniki działania tej funkcji są buforowane. Zobacz opis funkcji clearstatcache() aby uzyskać więcej informacji.

Wskazówka

Od PHP 5.0.0 ta funkcja może być użyta także z niektórymi nakładkami URL. Zobacz Supported Protocols and Wrappers aby uzyskać listę nakładek, które obsługują funkcjonalność z rodziny stat().

Zobacz też:


Funkcje Systemu plików
PHP Manual