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

filetypeRetourne le type de fichier


filetype(string $filename): string|false

Retourne le type d'un fichier donné.

Liste de paramètres


Chemin vers le fichier.

Valeurs de retour

Retourne le type du fichier. Les réponses possibles sont : fifo, char, dir, block, link, file socket et unknown.

Retourne false en cas d'erreur. filetype() va aussi émettre une erreur E_NOTICE si l'appel stat échoue, ou si le type de fichier est inconnu.

Erreurs / Exceptions

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


Exemple #1 Exemple avec filetype()


echo filetype('/etc/passwd');  // file
echo filetype('/etc/');        // dir



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


À 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_file() - Indique si le fichier est un véritable fichier
  • is_link() - Indique si le fichier est un lien symbolique
  • file_exists() - Vérifie si un fichier ou un dossier existe
  • mime_content_type() - Détecte le type de contenu d'un fichier
  • pathinfo() - Retourne des informations sur un chemin système
  • stat() - Renvoie les informations à propos d'un fichier

add a note add a note

User Contributed Notes 6 notes

ruach at chpc dot utah dot edu
18 years ago
There are 7 values that can be returned. Here is a list of them and what each one means

block: block special device

char: character special device

dir: directory

fifo: FIFO (named pipe)

file: regular file

link: symbolic link

unknown: unknown file type
11 years ago
filetype() does not work for files >=2GB on x86 Linux. You can use stat as a workarround:

$type=trim(`stat -c%F $file`);

Note that stat returns diffenerent strings ("regular file","directory",...)
7r6ivyeo at mail dot com
13 years ago
I use the CLI version of PHP on Windows Vista.  Here's how to determine if a file is marked "hidden" by NTFS:

function is_hidden_file($fn) {

$attr = trim(exec('FOR %A IN ("'.$fn.'") DO @ECHO %~aA'));

$attr[3] === 'h')


Changing <?php if($attr[3] === 'h') ?> to <?php if($attr[4] === 's') ?> will check for system files.

This should work on any Windows OS that provides DOS shell commands.
Abhi Jain
11 years ago
Putting @ in front of the filetype() function does not prevent it from raising a warning (Lstat failed), if E_WARNING is enabled on your error_reporting.

The most common cause of filetype() raising this warning and not showing a filetype() in the output (it actually returns NULL) is, if you happened to pass just the 'Dir or File Name' and not the complete "Absolute or Relative Path" to that 'file or Dir'. It may still read that file and return its filetype as "file" but for Dir's it shows warning and outputs NULL.
$pathToFile = '/var/www';
$file = 'test.php';
$dir = 'somedir';

Output for filetype($file) will be returned as 'file' and possibly without any warning, but for filetype($dir), it will return NULL with the warning "Lstat failed", unless you pass a complete path to that dir, i.e. filetype($pathToFile.'/'.$dir).

This happened to me and found this solution after a lot of trial and error. Thought, it might help someone.
7 years ago
Note there is a bug when using filetype with for example Japanese filenames :

The whole PHP interpreter comes crashing down without anyway to avoid it or capture an exception.
r dot koelpin at evisionteam dot de
8 years ago

echo "Zum testen müssen tatsächlich existente Namen verwendet werden.<br>";
"Pfad und Dateiname müssen getrennt eingetragen und durch einen Punkt verbunden sein.<br>";
"Example: [filetype(\"../dir/u_dir/\".\"temp.jpg\")] liefert -> file<br>";
To Top