# is_dir

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

is_dir — Indique si le fichier est un dossier

### Description

is_dir(string `$filename`): bool

Indique si le fichier est un dossier.

### Liste de paramètres

`filename`

  Chemin vers le fichier. Si `filename` est un fichier relatif, il sera vérifié relativement au dossier de travail courant. Si `filename` est un lien symbolique ou un lien conventionnel, le lien sera résolu et vérifié. Si vous avez activé open_basedir, plus de restrictions peuvent être appliquées.

### Valeurs de retour

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

### Erreurs / Exceptions

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

### Exemples

Exemple #1 Exemple avec is_dir()

`<?php
var_dump(is_dir('a_file.txt'));
var_dump(is_dir('bogus_dir/abc'));
var_dump(is_dir('..')); // un dossier au dessus
?>`

L'exemple ci-dessus va afficher :

    bool(false)
    bool(false)
    bool(true)

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

- chdir() - Change de dossier
- dir() - Retourne une instance de la classe Directory
- opendir() - Ouvre un dossier, et récupère un pointeur dessus
- is_file() - Indique si le fichier est un véritable fichier
- is_link() - Indique si le fichier est un lien symbolique