Edit Report a Bug

    filetype

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

    filetype — 取得文件类型

    说明

    filetype(string $filename): string|false

    返回文件的类型。

    参数

    filename

    文件的路径。

    返回值

    返回文件的类型。 可能的值有 fifo，char，dir，block，link，file 和 unknown。

    如果出错则返回 false。如果 stat 调用失败或者文件类型未知的话 filetype() 还会产生一个 E_NOTICE 消息。

    错误／异常

    失败时抛出 E_WARNING 警告。

    示例

    示例 #1 filetype() 例子

    <?php

    echo filetype('/etc/passwd');
    echo     "\n";
    echo     filetype('/etc/');

    ?>

    以上示例会输出：

    file
dir

    注释

    注意: 此函数的结果会被缓存。参见 clearstatcache() 以获得更多细节。

    小技巧

    自 PHP 5.0.0 起, 此函数也用于某些 URL 包装器。请参见 支持的协议和封装协议以获得支持 stat() 系列函数功能的包装器列表。

    参见

    add a note add a note

    User Contributed Notes 6 notes

    up
    24
    ruach at chpc dot utah dot edu
    20 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
    up
    10
    adlerweb
    14 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",...)
    up
    0
    7r6ivyeo at mail dot com
    16 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:

    <?php
    function is_hidden_file($fn) {

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

        if(    $attr[3] === 'h')
            return     true;

        return     false;
    }
    ?>

    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.
    up
    -2
    Abhi Jain
    13 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.
    eg:
    $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.
    up
    -3
    Anonymous
    9 years ago
    Note there is a bug when using filetype with for example Japanese filenames :
    https://bugs.php.net/bug.php?id=64699

    The whole PHP interpreter comes crashing down without anyway to avoid it or capture an exception.
    up
    -19
    r dot koelpin at evisionteam dot de
    10 years ago
    /* COPY/PASTE */
    <?php
    //https://php.net/manual/de/function.filetype.php#104308

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