略微加速

PHP官方手册 - 互联网笔记

PHP - Manual: rmdir

2024-12-22

rmdir

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

rmdir删除目录

说明

rmdir(string $dirname, resource $context = ?): bool

尝试删除 dirname 所指定的目录。 该目录必须是空的,而且要有相应的权限。 失败时会产生一个 E_WARNING 级别的错误。

参数

dirname

目录的路径。

context

上下文流(context stream) resource

返回值

成功时返回 true, 或者在失败时返回 false

范例

示例 #1 rmdir() 例子

<?php
if (!is_dir('examples')) {
    
mkdir('examples');
}

rmdir('examples');
?>

参见

add a noteadd a note

User Contributed Notes 29 notes

up
196
nbari at dalmp dot com
9 years ago
Glob function doesn't return the hidden files, therefore scandir can be more useful, when trying to delete recursively a tree.

<?php
public static function delTree($dir) {
  
$files = array_diff(scandir($dir), array('.','..'));
    foreach (
$files as $file) {
      (
is_dir("$dir/$file")) ? delTree("$dir/$file") : unlink("$dir/$file");
    }
    return
rmdir($dir);
  }
?>
up
44
info at top-info dot org
12 years ago
The function delTree is dangerous when you dont take really care. I for example always deleted a temporary directory with it. Everthing went fine until the moment where the var containing this temporary directory wasnt set. The var didnt contain the path but an empty string. The function delTree  was called and deleted all the files at my host!
So dont use this function when you dont have a proper handling coded. Dont think about using this function only for testing without such a handling.
Luckily nothing is lost because I had the local copy...
up
34
dj dot thd at hotmail dot com
6 years ago
Never ever use jurchiks101 at gmail dot com code!!! It contains command injection vulnerability!!!
If you want to do it that way, use something like this instead:

<?php
if (PHP_OS === 'Windows')
{
   
exec(sprintf("rd /s /q %s", escapeshellarg($path)));
}
else
{
   
exec(sprintf("rm -rf %s", escapeshellarg($path)));
}
?>

Note the escapeshellarg usage to escape any possible unwanted character, this avoids putting commands in $path variable so the possibility of someone "pwning" the server with this code
up
31
itay at itgoldman dot com
7 years ago
some implementations of recursive folder delete don't work so well (some give warnings, other don't delete hidden files etc).

this one is working fine:
<?php

function rrmdir($src) {
   
$dir = opendir($src);
    while(
false !== ( $file = readdir($dir)) ) {
        if ((
$file != '.' ) && ( $file != '..' )) {
           
$full = $src . '/' . $file;
            if (
is_dir($full) ) {
               
rrmdir($full);
            }
            else {
               
unlink($full);
            }
        }
    }
   
closedir($dir);
   
rmdir($src);
}

?>
up
14
wolfoneil at gmx.de
7 years ago
I was working on some Dataoperation, and just wanted to share an OOP method with you.

It just removes any contents of a Directory but not the target Directory itself! Its really nice if you want to clean a BackupDirectory or Log.

Also you can test on it if something went wrong or if it just done its Work!

I have it in a FileHandler class for example, enjoy!

<?php

 
public function deleteContent($path){
      try{
       
$iterator = new DirectoryIterator($path);
        foreach (
$iterator as $fileinfo ) {
          if(
$fileinfo->isDot())continue;
          if(
$fileinfo->isDir()){
            if(
deleteContent($fileinfo->getPathname()))
              @
rmdir($fileinfo->getPathname());
          }
          if(
$fileinfo->isFile()){
            @
unlink($fileinfo->getPathname());
          }
        }
      } catch (
Exception $e ){
        
// write log
        
return false;
      }
      return
true;
    }

?>
up
7
steffen at wirsching-idstein dot de
12 years ago
Say, you're working on Windows and continue to get a permission's error without a reason. Then it may be that a different Windows program is working on the folder (see earlier notes also). In the case that you can't find that program, the line

<?php closedir(opendir($dirname)); ?>

may solve the problem!
Make sure to write this before rmdir($dirname);.
up
40
holger1 at NOSPAMzentralplan dot de
11 years ago
Another simple way to recursively delete a directory that is not empty:

<?php
function rrmdir($dir) {
   if (
is_dir($dir)) {
    
$objects = scandir($dir);
     foreach (
$objects as $object) {
       if (
$object != "." && $object != "..") {
         if (
filetype($dir."/".$object) == "dir") rrmdir($dir."/".$object); else unlink($dir."/".$object);
       }
     }
    
reset($objects);
    
rmdir($dir);
   }
}
?>
up
7
Anonymous
5 years ago
itay at itgoldman's function falls into an infinite loop if the $src directory doesn't exist.
Here's a fix - one should do at least a file_exists() check before the loop:

function rrmdir($src) {
    if (file_exists($src)) {
        $dir = opendir($src);
        while (false !== ($file = readdir($dir))) {
            if (($file != '.') && ($file != '..')) {
                $full = $src . '/' . $file;
                if (is_dir($full)) {
                    rrmdir($full);
                } else {
                    unlink($full);
                }
            }
        }
        closedir($dir);
        rmdir($src);
    }
}

Thanks to itay for the original function, though, it was helpful.
up
1
anonymous_user
1 year ago
// Recursive PHP function to completely remove a directory

function delete_directory_recursively( $path ) {

      $dir = new \DirectoryIterator( $path );

      // Iterate through the subdirectories / files of the provided directory
      foreach ( $dir as $dir_info ) {

        // Exclude the . (current directory) and .. (parent directory) paths
        // from the directory iteration
        if ( ! $dir_info->isDot() ) {

          // Get the full currently iterated path
          $iterated_path = $dir_info->getPathname();

          // If the currently iterated path is a directory
          if ( $dir_info->isDir() ) {

            // which is not empty (in which case scandir returns an array of not 2 (. and ..) elements)
            if ( count( scandir( $iterated_path ) ) !== 2 ) {

              // Call the function recursively
              self::remove_directory_recursively( $iterated_path );

            } else {

              // if the currently iterated path is an empty directory, remove it
              rmdir( $iterated_path );

            }

          } elseif ( $dir_info->isFile() ) {

            // If the currently iterated path describes a file, we need to
            // delete that file
            unlink( $iterated_path );

          }

        } // loop which opens if the currently iterated directory is neither . nor ..

      } // end of iteration through directories / files of provided path

      // After iterating through the subpaths of the provided path, remove the
      // concerned path
      rmdir( $path );

    } // end of delete_directory_recursively() function definition
up
5
Chris Wren
9 years ago
I also ran into the permissions issue in Windows when deleting a folder and the solution was to close all editors which had files opened which were located in the folder structure.
up
5
shane dot ray87 at gmail dot com
10 years ago
This issue has been driving me nuts for hours.

I am running PHP on IIS, I had the wincache module installed, when running a recursive delete a certain folder would get "stuck" and throw permissions errors.  I was not able to delete them with PHP or in windows itself.  The only way to delete the folder was to wait 5 min and run the script again, or stop the IIS server and the folder would delete on its own.  Disabling the wincachce module resolved the issue.

Hope this helps.
up
4
ahmadmarafa at gmail dot com
7 years ago
function unlinkDir($dir)
{
    $dirs = array($dir);
    $files = array() ;
    for($i=0;;$i++)
    {
        if(isset($dirs[$i]))
            $dir =  $dirs[$i];
        else
            break ;
   
        if($openDir = opendir($dir))
        {
            while($readDir = @readdir($openDir))
            {
                if($readDir != "." && $readDir != "..")
                {
                
                    if(is_dir($dir."/".$readDir))
                    {
                        $dirs[] = $dir."/".$readDir ;
                    }
                    else
                    {
                       
                        $files[] = $dir."/".$readDir ;
                    }
                }
            }
       
        }
       
    }
   
   
   
    foreach($files as $file)
    {
        unlink($file) ;
    
    }
    $dirs = array_reverse($dirs) ;
    foreach($dirs as $dir)
    {
        rmdir($dir) ;
    }
   
}
up
13
lprent at primary dot geek dot nz
8 years ago
It is rather dangerous to recurse into symbolically linked directories. The delTree should be modified to check for links.

<?php
public static function delTree($dir) {
  
$files = array_diff(scandir($dir), array('.','..'));
    foreach (
$files as $file) {
      (
is_dir("$dir/$file") && !is_link($dir)) ? delTree("$dir/$file") : unlink("$dir/$file");
    }
    return
rmdir($dir);
  }
?>
up
2
mmakshita2398 at gmail dot com
3 years ago
it Will Delete All Fildes in folder and that folder too...

echo $path = 'D:\xampp\htdocs\New folder\New folder';

function rmdir_recursive($dir) {
    $it = new RecursiveDirectoryIterator($dir, FilesystemIterator::SKIP_DOTS);
    $it = new RecursiveIteratorIterator($it, RecursiveIteratorIterator::CHILD_FIRST);
    foreach($it as $file) {
        if ($file->isDir()) rmdir($file->getPathname());
        else unlink($file->getPathname());
    }
    rmdir($dir);
}
rmdir_recursive($path);
up
3
rn at clubfl dot com
14 years ago
I've noticed that when using this command on a windows platform you may encounter a permissions error which may seem unwarranted. This commonly occurs if you are or were using a program to edit something in the to be deleted folder and either the item is still in the folder or the program that was accessing the file in that folder is still running(causing it to hold onto the folder).

SO... if you get a permissions error and there shouldn't be an issue with folder permissions check if there are files in there then check if there is a program running that is or was using a file that was in that folder and kill it.
up
4
tuxedobob
8 years ago
Keep in mind that if you know what your host OS is, you can always just call the appropriate system call using exec() or the like. For example:

exec('rmdir folder-to-delete /s /q'); //windows
exec('rmdir -rf folder-to-delete'); //OS X/*nix?
up
3
thomas
10 years ago
Function deleteAll given by O S on 18-Jun-2010 11:30 will fail at line

while ($contents = readdir($directoryHandle)) {...

if a folder named 0 (zero) is found during traversing the hierarchy
up
3
Baraka Mghumba
7 years ago
Works fine, tested on PHP 5.4(EasyPHP server)
function deletedir($dir)
    {
        if (is_dir($dir))
        {
            $files = scandir($dir);
            foreach ($files as $file)
            {
                if ($file != "." && $file != "..")
                {
                    if (filetype($dir."/".$file) == "dir")
                    {
                        $this->deletedir($dir."/".$file);
                    }
                    else
                    {
                        unlink($dir."/".$file);
                    }
                }
            }
            reset($objects);
            if(rmdir($dir))
            {
                return 'deleted successfully!';
            }
            else
            {
                return 'delete failed!';
            }
        }
        else
        {
            return 'doesn\'t exist or inaccessible!';
        }
    }
Something to note:
You have to take care of file permission if necessary
up
5
asn at asn24 dot dk
12 years ago
A patch to previous script to make sure rights for deletion is set:

<?php
//Delete folder function
function deleteDirectory($dir) {
    if (!
file_exists($dir)) return true;
    if (!
is_dir($dir) || is_link($dir)) return unlink($dir);
        foreach (
scandir($dir) as $item) {
            if (
$item == '.' || $item == '..') continue;
            if (!
deleteDirectory($dir . "/" . $item)) {
               
chmod($dir . "/" . $item, 0777);
                if (!
deleteDirectory($dir . "/" . $item)) return false;
            };
        }
        return
rmdir($dir);
    }
?>

[EDITOR NOTE: "Credits to erkethan at free dot fr." - thiago]
up
4
omikrosys at gmail dot com
12 years ago
Sometimes you would face situations in which rmdir($dirname) would give "permission denied" errors though you may have changed $dirname permissions. In such situations just change the permissions of the directory which contains $dirname and rmdir($dirname) would work like a charm.
Say you use rmdir('dirr'); then change the permissions of the folder that contains 'dirr'.
up
2
samy dot see at gmail dot com
10 years ago
if you get this problem Permission denied in windows testing your site maybe this will resolve the problem

<?php
if(file_exists($path.'/Thumbs.db')){
   
unlink($path.'/Thumbs.db');
}
?>

and then

<?php rmdir($path); ?>
up
2
TrashF at taistelumarsu dot org
13 years ago
In case you're trying to rmdir() and you keep getting 'Permission denied' errors, make sure you don't have the directory still open after using opendir(). Especially when writing recursive functions for deleting directories, make sure you have closedir() BEFORE rmdir().
up
1
bcairns at gmail dot com
12 years ago
I wasn't having much luck with the recursive delete functions below, so I wrote my own:

<?php
// ensure $dir ends with a slash
function delTree($dir) {
   
$files = glob( $dir . '*', GLOB_MARK );
    foreach(
$files as $file ){
        if(
substr( $file, -1 ) == '/' )
           
delTree( $file );
        else
           
unlink( $file );
    }
   
rmdir( $dir );
}
?>

Simple.  Works.
up
1
longears at BLERG dot gmail dot com
10 years ago
Concise way to recursively remove a directory:

<?php
# recursively remove a directory
function rrmdir($dir) {
    foreach(
glob($dir . '/*') as $file) {
        if(
is_dir($file))
           
rrmdir($file);
        else
           
unlink($file);
    }
   
rmdir($dir);
}
?>
up
0
O S
12 years ago
This isn't my code, but just thought I would share, since it took me so long to find. This is a function to delete a folder, all sub-folders, and files in one clean move.

Just tell it what directory you want deleted, in relation to the page that this function is executed. Then set $empty = true if you want the folder just emptied, but not deleted. If you set $empty = false, or just simply leave it out, the given directory will be deleted, as well.

<?php
function deleteAll($directory, $empty = false) {
    if(
substr($directory,-1) == "/") {
       
$directory = substr($directory,0,-1);
    }

    if(!
file_exists($directory) || !is_dir($directory)) {
        return
false;
    } elseif(!
is_readable($directory)) {
        return
false;
    } else {
       
$directoryHandle = opendir($directory);
       
        while (
$contents = readdir($directoryHandle)) {
            if(
$contents != '.' && $contents != '..') {
               
$path = $directory . "/" . $contents;
               
                if(
is_dir($path)) {
                   
deleteAll($path);
                } else {
                   
unlink($path);
                }
            }
        }
       
       
closedir($directoryHandle);

        if(
$empty == false) {
            if(!
rmdir($directory)) {
                return
false;
            }
        }
       
        return
true;
    }
}
?>
up
-1
kevin at web-power dot co dot uk
12 years ago
I had situation where the rmdir was returning warning message as within last loop it was already removed. So here is quick fix by adding is_dir to the DelTree routine below

<?php
function delTree($dir) {
   
$files = glob( $dir . '*', GLOB_MARK );
    foreach(
$files as $file ){
        if(
substr( $file, -1 ) == '/' )
           
delTree( $file );
        else
           
unlink( $file );
    }
   
    if (
is_dir($dir)) rmdir( $dir );
   
}
?>
up
-2
YAPs
5 years ago
This version delete tree

<?PHP

if(!defined('DS'))define("DS",DIRECTORY_SEPARATOR);

function
delTree($folder,$del_root=true)
{
   
$folder=trim($folder,DS).DS;
   
$f=glob($folder.'*',GLOB_MARK);
    if(
count($f)>0)
        foreach(
$f as $e)
        {
            if(
is_dir($e))
               
delTree($e);
            else
               
unlink($e);
        }
        if(
$del_root)
           
rmdir($folder);
        if(!
file_exists($folder))
            return
$folder." is deleted";
        else
            return
$folder." not deleted";
}
?>
up
-2
frederico05 dot figueira at gmail dot com
6 years ago
//This is one example to delete full directory with all files inside there

function delDir($path){
        if(is_dir($path) == TRUE){
            $rootFolder = scandir($path);
            if(sizeof($rootFolder) > 2){
                foreach($rootFolder as $folder){
                    if($folder != "." && $folder != ".."){
//Pass the subfolder to function
                        delDir($path."/".$folder);
                    }
                }
//On the end of foreach the directory will be cleaned, and you will can use rmdir, to remove it
                rmdir($path);
            }
        }else{
            if(file_exists($path) == TRUE){
                unlink($path);
            }
        }
    }
up
-54
jurchiks101 at gmail dot com
7 years ago
This function sorely needs a built-in option to delete the contents of the directory. Or another function that does exactly that - deletes a path (file or folder, doesn't matter).
It is still much simpler to just use something like the following to delete any directory rather than write some 10+ line function that has corner cases that will break it:
<?php
if (PHP_OS === 'Windows')
{
   
exec("rd /s /q {$path}");
}
else
{
   
exec("rm -rf {$path}");
}
?>
Most webservers are run on 2 or 3 different popular operating systems, so this would easily work for almost all websites.

官方地址:https://www.php.net/manual/en/function.rmdir.php

北京半月雨文化科技有限公司.版权所有 京ICP备12026184号-3