search for in the  
<globis_executable>
Last updated: Thu, 19 May 2005

is_dir

(PHP 3, PHP 4, PHP 5)

is_dir -- Tells whether the filename is a directory

Description

bool is_dir ( string filename )

Returns TRUE if the filename exists and is a directory. If filename is a relative filename, it will be checked relative to the current working directory.

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

Example 1. is_dir() example

<?
var_dump(is_dir('a_file.txt')) . "\n";
var_dump(is_dir('bogus_dir/abc')) . "\n";

var_dump(is_dir('..')); //one dir up
?>

The above example will output:

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

Tip: As of PHP 5.0.0 this function can also be used with some URL wrappers. Refer to Appendix L for a listing of which wrappers support stat() family of functionality.

See also chdir(), dir, opendir(), is_file() and is_link().



User Contributed Notes
is_dir
renich at woralelandia dot com
21-Apr-2005 01:45
Here goes a PHP5.0 link-to-directory listing function and examples

<?php

//List directories only
function list_dirs($path, $target)
{
   $list = scandir($path);
  
   foreach ($list as $number => $filename)
   {
       if ( $filename !== '.' && $filename !== '..' && is_dir("$path/$filename") )
       {
           // Asign more readable and logic variables
           $dir = $filename;
           $url = apache_request_headers();
          
           if ($target == '')
           {
               // Print Dirs with link
               print ("<a href=\"http://$url[Host]/$path/$dir\">$dir</a> <br>\n");
           }
           else
           {
               // Print Dirs with link
               print ("<a href=\"http://$url[Host]$dir\" target=\"$target\">$dir</a> <br>\n");
           }
              
       }
   }
}
  
?>

1.- List current directory's directories with no target property.

<?php

list_dirs('.','')

?>

2.- List "libraries" in "pma2" located at my dir with a "_blank" target set

<?php

list_dirs('pma2/libraries','_blank');

?>

or

<?php

list_dirs('/var/www/html/pma2/libraries','_blank');

?>

3.- List all the directories located at the "/Home" dir with "_me" as target.

<?php

list_dirs('/home', ''_me');

?>

I hope you all like it!

Note:
Obviously, the links will now work if the're not in the apache dir... ("htdocs", "html", "www", whatever)
dusted19 at hotmail dot com
19-Mar-2005 04:38
While working on a php project (my first one =( ).  I ran into a bug using is_dir() on my winxp w/ servicepack 2 system.  I'm using php 4.3.10.. the problem is whenever i pass is_dir() a pathname that is longer then 256 characters long it will ALWAYS return true.

CODE:

<?php

// Path to multimedia files
$mpath = "E:\\armoury\\";
ls($mpath);

//echo "MP3 Listing:<br/><br/>";

function ls ($curpath) {
   $dir = dir($curpath);
   echo("<b>$curpath</b>");
   echo "<blockquote>";
   while ($file = $dir->read()) {
                   echo(" <b>");
                   echo(strlen($curpath.$file));
                   echo("</b> ");
           if($file != "." && $file != "..") {
               if (is_dir($curpath.$file)) {
                   ls($curpath.$file."\\");
               } else {
                   echo(" $file<br>");
               }

           }

//      }
   }
   $dir->close();
   echo "</blockquote>";
   return;
}

?>

This is the output.. the number preceding the file/directory is the number of characters in it's full path name.  You can see where it trips up at:

 257 E:\armoury\[ hiphop - dub - reggae - soul ]\A Tribe Called Quest - 1990 - People's Instinctive Travels And The Paths Of Rhythm\A Tribe Called Quest - People's Instinctive Travels And The Paths Of Rhythm - 10 - Rhythm (Devoted To The Art Of Moving Butts).mp3

The pathname is greater then 256 characters.

229 A Tribe Called Quest - People's Instinctive Travels And The Paths Of Rhythm - 07 - Bonita Applebum.mp3
227 A Tribe Called Quest - People's Instinctive Travels And The Paths Of Rhythm - 08 - Can I Kick It.mp3
233 A Tribe Called Quest - People's Instinctive Travels And The Paths Of Rhythm - 09 - Youthful Expression.mp3
257 E:\armoury\[ hiphop - dub - reggae - soul ]\A Tribe Called Quest - 1990 - People's Instinctive Travels And The Paths Of Rhythm\A Tribe Called Quest - People's Instinctive Travels And The Paths Of Rhythm - 10 - Rhythm (Devoted To The Art Of Moving Butts).mp3\
259 260 267 E:\armoury\[ hiphop - dub - reggae - soul ]\A Tribe Called Quest - 1990 - People's Instinctive Travels And The Paths Of Rhythm\A Tribe Called Quest - People's Instinctive Travels And The Paths Of Rhythm - 10 - Rhythm (Devoted To The Art Of Moving Butts).mp3\index.php\
269 270 277 E:\armoury\[ hiphop - dub - reggae - soul ]\A Tribe Called Quest - 1990 - People's Instinctive Travels And The Paths Of Rhythm\A Tribe Called Quest - People's Instinctive Travels And The Paths Of Rhythm - 10 - Rhythm (Devoted To The Art Of Moving Butts).mp3\index.php\index.php\

Try it yourself on a large directory structure.
flobee
13-Mar-2005 08:13
note: like the main example already shows. tooks me houres to understand und using chdir() to get a full dir scann (especilly on windows and "mounted" network drives)

never forget the tailing slash to find out if you have a directory or not.
<?php
function parse_dir($dir) {
   if ($dh = @opendir($dir)) {
       while(($file = readdir($dh)) !== false) {
           if( !preg_match('/^\./s', $file) )  {
               if(is_dir($dir.$file)) {
                   $newdir = $dir.$file.'/'; // <- tailing slash
                   chdir($newdir);
                   echo "IS DIR: $newdir\n";
                   echo parse_dir($newdir);
               } else {
                   echo $dir.$file."\n";
               }
           }           
       }
       chdir('..');
   }
}
parse_dir('z:/myfolder/mysubfolder/');

?>
puremango dot co dot uk at gmail dot com
08-Feb-2005 01:55
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
02-Feb-2005 06:12
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;
}
tibard at gmail dot com
01-Feb-2005 02:32
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;
}

?>
rchavezc at ameritech dot net
12-Dec-2004 10:19
This is the function that I use to test for an empty directory:

<?php
function is_emtpy_dir($dirname){

// Returns true if  $dirname is a directory and it is empty

   $result=false;                      // Assume it is not a directory
   if(is_dir($dirname) ){
       $result=true;                  // It is a directory
       $handle = opendir($dirname);
       while( ( $name = readdir($handle)) !== false){
               if ($name!= "." && $name !=".."){
             $result=false;        // directory not empty
             break;                  // no need to test more
           }
       }
       closedir($handle);
   }
   return $result;
}
?>
bhuskins at nospam dot christian-horizons dot org
12-Aug-2004 03:51
'Is_empty_folder' posted by andreas at rueping dot net is a nice function. It did give me some grief, though. I don't beleive that it actually closes the directory when it's done (closedir in the wrong spot). I changed it slightly to be the following:

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

<?
function is_emtpy_folder($folder){
   if(is_dir($folder) ){
       $handle = opendir($folder);
       while( (gettype( $name = readdir($handle)) != "boolean")){
               $name_array[] = $name;
       }
       foreach($name_array as $temp)
           $folder_content .= $temp;

       closedir($handle);//<--------moved this
       if($folder_content == "...") {
           return true;
       } else {
           return false;
       }
   }
   else
       return true; // folder doesnt exist
}
?>
sly at noiretblanc dot org
28-May-2004 12:10
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.
p dot marzec at bold-sg dot pl
14-Mar-2004 09:33
Simplest version 'is_empty_folder' posted by andreas at rueping dot net

// 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($name)) {
       return false;
       break;
       }
   }
       closedir($dl);
       }
   return true;
   } else return true;
}
andreas at rueping dot net
23-Sep-2003 07:29
function checks if a folder is empty or not. Retruns "true" if it is empty and "false" if it is full with data. Also if the folder doesnt even exist, function returns "true".

--------------------------------------------------
--------------------------------------------------

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

<?
function is_emtpy_folder($folder){
   if(is_dir($folder) ){
       $handle = opendir($folder);
       while( (gettype( $name = readdir($handle)) != "boolean")){
               $name_array[] = $name;
       }
       foreach($name_array as $temp)
           $folder_content .= $temp;

       if($folder_content == "...")
           return true;
       else
           return false;
      
       closedir($handle);
   }
   else
       return true; // folder doesnt exist
}
?>

<globis_executable>
 Last updated: Thu, 19 May 2005
Copyright © 2001-2005 The PHP Group
All rights reserved.		 This unofficial mirror is operated at: The Server Pages
Last updated: Thu May 19 17:35:34 2005 CDT