# is_file

(PHP 4, PHP 5, PHP 7, PHP 8)

is_file — Indique si le fichier est un véritable fichier

### Description

is_file(string `$filename`): bool

Indique si le fichier est un véritable fichier. Si `filename` est un lien symbolique, il résoudra le lien et fournira des informations sur le fichier référencé.

### Liste de paramètres

`filename`

  Chemin vers le fichier.

### Valeurs de retour

Retourne `true` si le nom de fichier existe et que c'est un fichier régulier, `false` sinon.

> 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.

### Erreurs / Exceptions

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

### Exemples

Exemple #1 Exemple avec is_file()

`<?php
var_dump(is_file('a_file.txt')) . "\n";
var_dump(is_file('/usr/bin/')) . "\n";
?>`

L'exemple ci-dessus va afficher :

    bool(true)
    bool(false)

### Notes

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

Astuce

À partir de 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_dir() - Indique si le fichier est un dossier
- is_link() - Indique si le fichier est un lien symbolique
- SplFileInfo