file_exists

(PHP 4, PHP 5)

file_existsVérifie si un fichier ou un dossier existe

Description

bool file_exists ( string $filename )

Vérifie si un fichier ou un dossier existe.

Liste de paramètres

filename

Chemin vers le fichier ou le dossier.

Sous Windows, utilisez le format de chemin //computername/share/filename ou \\\\computername\share\filename pour vérifier qu'un fichier est disponible sur le partage réseau.

Valeurs de retour

Retourne TRUE si le fichier ou le dossier spécifié par le paramètre filename existe ; FALSE sinon.

Note:

Retourne FALSE pour les liens symboliques pointant vers un fichier qui n'existe pas.

Avertissement

Cette fonction retourne FALSE pour les fichiers non accessibles en raison des restrictions du safe mode. Cependant, ces fichiers peuvent toujours être inclus s'ils sont dans le dossier safe_mode_include_dir.

Note:

La vérification est effectuée en utilisant l'UID/GID réel au lieu de l'effectif.

Note: Comme le type entier de PHP est signé et que de nombreuses plates-formes utilisent des entiers de 32 bits, certaines fonctions relatives au système de fichiers peuvent retourner des résultats étranges pour les fichiers de taille supérieure à 2 Go.

Exemples

Exemple #1 Teste l'existence d'un fichier

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

if (file_exists($filename)) {
	echo "Le fichier $filename existe.";
} else {
	echo "Le fichier $filename n'existe pas.";
}
?>

Erreurs / Exceptions

En cas d'échec, une alerte de type E_WARNING sera émise.

Notes

Note: Les résultats de cette fonction sont mis en cache. Voyez la fonction clearstatcache() pour plus de détails.

Astuce

Depuis PHP 5.0.0, cette fonction peut aussi être utilisée avec quelques protocoles url. Lisez Liste des protocoles et des gestionnaires supportés pour connaître les protocoles supportant la famille de fonctionnalités de stat().

Voir aussi

  • is_readable() - Indique si un fichier existe et est accessible en lecture
  • is_writable() - Indique si un fichier est accessible en écriture
  • is_file() - Indique si le fichier est un véritable fichier
  • file() - Lit le fichier et renvoie le résultat dans un tableau

LoadingChargement en cours