dismiss Step into the future! Click here to switch to the beta php.net site
downloads | documentation | faq | getting help | mailing lists | licenses | wiki | reporting bugs | php.net sites | conferences | my php.net

search for in the

flock> <filesize
[edit] Last updated: Fri, 28 Jun 2013

view this page in

filetype

(PHP 4, PHP 5)

filetypeGets file type

Description

string filetype ( string $filename )

Returns the type of the given file.

Parameters

filename

Path to the file.

Return Values

Returns the type of the file. Possible values are fifo, char, dir, block, link, file, socket and unknown.

Returns FALSE if an error occurs. filetype() will also produce an E_NOTICE message if the stat call fails or if the file type is unknown.

Examples

Example #1 filetype() example

<?php

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

?>

Errors/Exceptions

Upon failure, an E_WARNING is emitted.

Notes

Note: The results of this function are cached. See clearstatcache() for more details.

Tip

As of PHP 5.0.0, this function can also be used with some URL wrappers. Refer to Supported Protocols and Wrappers to determine which wrappers support stat() family of functionality.

See Also

  • is_dir() - Tells whether the filename is a directory
  • is_file() - Tells whether the filename is a regular file
  • is_link() - Tells whether the filename is a symbolic link
  • file_exists() - Checks whether a file or directory exists
  • mime_content_type() - Detect MIME Content-type for a file (deprecated)
  • pathinfo() - Returns information about a file path
  • stat() - Gives information about a file



flock> <filesize
[edit] Last updated: Fri, 28 Jun 2013
 
add a note add a note User Contributed Notes filetype - [5 notes]
up
1
Abhi Jain
2 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
1
ruach at chpc dot utah dot edu
9 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
1
adlerweb
2 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
4 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
-3
holdoffhunger at gmail dot com
1 year ago
Something you may eventually want to do is to know the type of file simply by the suffix of the filename.  Functions like finfo_file and mime_ content_ type come close, but they don't actually list the filename suffix (like "txt" for "readme.txt"), and this filetype function seems to list "directory" or "file" only.

Knowing the filename suffix can be very useful, especially when managing a filesystem that has copies.  It's better to name the copy of a file as "readme(copy-1).txt" rather than "readme.txt(copy-1)", since the latter option probably isn't going to cooperate so well with your text editor/reader.  Here's a little code below that returns the suffix of a filename in a string.  It returns both the prefix and the suffix of the filename :

<?php

       
// Example Filename: "Homepage.php"
        // ------------------------------------

   
$file_name = "Homepage.php";

       
// Filename Data
        // ------------------------------------

   
$length_of_filename = strlen($file_name);
   
$last_char = substr($file_name, $length_of_filename - 1, 1);

       
// Parse Filename Backwards
        // ------------------------------------
   
   
for($i_parse_name = 0; $i_parse_name < $length_of_filename; $i_parse_name++)
    {

           
// Gather Data and Detect
            // ------------------------------------
       
       
$last_char = substr($file_name, $length_of_filename - $i_parse_name + 2, 1);
       
        if(
$last_char == ".")
        {
           
$filename_suffix = substr($file_name, $length_of_filename - $i_parse_name + 2, $i_parse_name);
           
$filename_prefix = substr($file_name, 0, $length_of_filename - strlen($filename_suffix));
           
$i_parse_name = $length_of_filename;
        }
    }
   
       
// Print Results
        // ------------------------------------
               
   
print("Filetype Results -- $filename_prefix ||| $filename_suffix");

       
// Example Results:
        // ------------------------------------
        //    Filetype Results -- Homepage ||| .php

?>

Other examples:

"Best.Page.in.the.Universe.xml"
    Filetype Results -- Best.Page.in.the.Universe ||| .xml

"Best.Page.in.the.Universe.xml5789"
    Filetype Results -- Best.Page.in.the.Universe ||| .xml5789

"Home.awesome.page.php"
    Filetype Results -- Home.awesome.page ||| .php

 
show source | credits | stats | sitemap | contact | advertising | mirror sites