PHP 5.6.0 released

is_dir

(PHP 4, PHP 5)

is_dirIndique si le fichier est un dossier

Description

bool is_dir ( string $filename )

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é le safe mode, ou 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.

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)

Erreurs / Exceptions

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

Notes

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

Astuce

Depuis 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

add a note add a note

User Contributed Notes 15 notes

up
6
digitalaudiorock at gmail dot com
4 years ago
Just a note for anyone who encounters is_dir() returning false on CIFS mount points or directories within those mount points on 2.6.31 and newer kernels: Apparently in new kernels they've started using the CIFS serverino option by default.  With Windows shares this causes huge inode numbers and which apparently can cause is_dir() to return false.  Adding the noserverino option to the CIFS mount will prevent this.  This may only occur on 32 systems but I don't have a 64 bit install to test against.
up
2
Anonymous
6 years ago
One note regarding checking for empty directories :
>>echo (count(glob("$dir/*")) === 0) ? 'Empty' : 'Not empty';
This does not work correctly on Linux.
The '.' and '..' will always be returned even if no files are present in the directory.
up
1
puremango dot co dot uk at gmail dot com
9 years ago
this function bypasses open_basedir restrictions.
<?
function my_is_dir($dir)
{
   
// bypasses open_basedir restrictions of is_dir and fileperms
   
$tmp_cmd = `ls -dl $dir`;
   
$dir_flag = $tmp_cmd[0];
    if(
$dir_flag!="d")
    {
       
// not d; use next char (first char might be 's' and is still directory)
       
$dir_flag = $tmp_cmd[1];
    }
    return (
$dir_flag=="d");
}
?>

example:
<?
....
echo
is_dir("/somewhere/i/dont/have/access/to");
?>
output:
Warning: open_basedir restriction in effect

<?
....
echo
my_is_dir("/somewhere/i/dont/have/access/to");
?>
output:
true (or false, depending whether it is or not...)

---
visit puremango.co.uk for other such wonders
up
1
Btx
5 years ago
<?php
public static function isEmptyDir($dir){
     return ((
$files = @scandir($dir)) && count($files) <= 2);
}
?>

better ;)
up
1
niceuser at live dot com
1 year ago
PITFALL in sub dir processing

After struggeling with a sub-dir processing (some subdirs were skipped) AND reading the posts, I realized that virutally no-one clearly told what were wrong.

The common traverse dir code was:
-----------------------------------------

opendir("myphotos"); // Top dir to process from (example)

while (false !== ($fname = readdir($h_dir))) { // process current dir (read a directory entry)

   if ($fname{0} == '.') continue; // skip dirs . and .. by first char test

   if (is_dir($fname)) call_own_subdir_process;  // process this subdir by calling a routine

   }

PROBLEM IS :

The "is_dir()" must have the FULL PATH or it will skip some dirs. So the above code need to INSERT THE PATH before the filename. This would give this change in above...

   if (is_dir("myphotos\" . $fname)) call_own_subdir_process;  // skip subdirs

The pitfall really was, that without full path some subdirs were found...hope this clears all up
up
0
vstoykov at consultant dot bg
5 years ago
When trying (no 'pear') to enumerate mounted drives on a win32  platform (Win XP SP3, Apache/2.2.11, PHP/5.2.9), I used:

<?php
function echo_win_drives() {

  for(
$c='A'; $c<='Z'; $c++)
    if(
is_dir($c . ':'))
      echo
$c . ': ';
}
?>

which yielded:
A: C: D: E: F: G: H: I:
up
0
alanguir at detroitchamber dot com
5 years ago
When I run a scandir I always run a simple filter to account for file system artifacts (especially from a simple ftp folder drop) and the "." ".." that shows up in every directory:

<?php
   
if (is_dir($folder){
       
$contents = scandir($folder);
       
$bad = array(".", "..", ".DS_Store", "_notes", "Thumbs.db");
       
$files = array_diff($contents, $bad);
    }
?>
up
0
jasoneisen at gee mail
6 years ago
An even better (PHP 5 only) alternative to "Davy Defaud's function":

<?php
function is_empty_dir($dir)
{
    if ((
$files = @scandir($dir)) && count($files) <= 2) {
        return
true;
    }
    return
false;
}
?>

NOTE: you should obviously be checking beforehand if $dir is actually a directory, and that it is readable, as only relying on this you would assume that in both cases you have a non-empty readable directory.
up
0
danr at cvisual dot com dot com
7 years ago
Running PHP 5.2.0 on Apache Windows, I had a problem (likely the same one as described by others) where is_dir returned a False for directories with certain permissions even though they were accessible.

Strangely, I was able to overcome the problem with a more complete path. For example, this only displays "Works" on subdirectories with particular permissions (in this directory about 1 out of 3):

$d = opendir("./albums/mydir");
while(false !== ($f = readdir($d))) {
    echo "<hr />";
        if(is_dir($f)) {
            echo "<b>Works:" . $f . "</b>";
        }
}

However, this works properly for all directories:

$d = opendir("./albums/mydir");
while(false !== ($f = readdir($d))) {
    echo "<hr />";
        $dName = "./albums/mydir/" . $f;
        if(is_dir($dName)) {
            echo "<b>Works:" . $dName . "</b>";
        }
}

I don't understand the hit-and-miss of the first code, but maybe the second code can help others having this problem.
up
0
tibard at gmail dot com
9 years ago
use this function to get all files inside a directory (including subdirectories)

<?php
function scan_Dir($dir) {
   
$arrfiles = array();
    if (
is_dir($dir)) {
        if (
$handle = opendir($dir)) {
           
chdir($dir);
            while (
false !== ($file = readdir($handle))) {
                if (
$file != "." && $file != "..") {
                    if (
is_dir($file)) {
                       
$arr = scan_Dir($file);
                        foreach (
$arr as $value) {
                           
$arrfiles[] = $dir."/".$value;
                        }
                    } else {
                       
$arrfiles[] = $dir."/".$file;
                    }
                }
            }
           
chdir("../");
        }
       
closedir($handle);
    }
    return
$arrfiles;
}

?>
up
0
sly at noiretblanc dot org
10 years ago
This is the "is_dir" function I use to solve the problems :

function Another_is_dir ($file)
{
    if ((fileperms("$file") & 0x4000) == 0x4000)
        return TRUE;
    else
        return FALSE;
}

or, more simple :

function Another_is_dir ($file)
{
return ((fileperms("$file") & 0x4000) == 0x4000);
}

I can't remember where it comes from, but it works fine.
up
-1
Victor
1 year ago
If you are using Mac, or others systems that store information about the directory layout and etc, the function:

   function empty_dir($dir) {
        if (($files = @scandir($dir)) && count($files) <= 3)
            return true;
        else
            return false;
    }

Must have the count($files) comparing with the number of hidden files!

For example, I'm using Mac and the empty directory shows me three files: ".", ".." and ".DS_Store", so if I am planning to put the website online on my Mac, I've to count in the ".DS_Store" file!
up
-1
gecko4 at gmail dot com
7 years ago
Here is another way to test if a directory is empty, which I think is much simpler than those posted below:

<?php
$dir
= 'directory';
echo (
count(glob("$dir/*")) === 0) ? 'Empty' : 'Not empty';
?>
up
-1
Eric
7 years ago
Ah ha!  Maybe this is a bug, or limitation to be more precise, of php. See http://bugs.php.net/bug.php?id=27792

A workaround is posted on the page (above) and seems to work for me:

function is_dir_LFS($path){
  return (('d'==substr(exec("ls -dl '$path'"),0,1))?(true):(false));
}

PS: I'm using PHP 4.3.10-16, posts report this problem up to 5.0
up
-1
Anonymous
9 years ago
Unfortunately, the function posted by p dot marzec at bold-sg dot pl does not work.
The corrected version is:

// returns true if folder is empty or not existing
// false if folde is full

function is_empty_folder($dir) {
if (is_dir($dir)) {
   $dl=opendir($dir);
   if ($dl) {
       while($name = readdir($dl)) {
   if (!is_dir("$dir/$name")) { //<--- corrected here
       return false;
       break;
       }
   }
       closedir($dl);
       }
   return true;
   } else return true;
}
To Top