萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 遞迴刪除目錄與內容:安全、高效、支援符號連結

核心函式

<?php
/**
 * 遞迴刪除目錄及其內容
 * @param string $dir  目錄路徑
 * @param bool   $self 是否刪除目錄本身 (true=整個目錄刪除, false=僅清空內容)
 * @return bool 成功與否
 */
function rrmdir(string $dir, bool $self = true): bool
{
    $dir = rtrim($dir, '/\\');
    if (!is_dir($dir)) return false;

    $items = new RecursiveIteratorIterator(
        new RecursiveDirectoryIterator($dir, FilesystemIterator::SKIP_DOTS),
        RecursiveIteratorIterator::CHILD_FIRST // 先刪子項,再刪父目錄
    );

    foreach ($items as $item) {
        $path = $item->getPathname();
        if ($item->isLink() || $item->isFile()) {
            @unlink($path); // 忽略權限錯誤,盡力刪除
        } elseif ($item->isDir()) {
            @rmdir($path);
        }
    }

    return $self ? @rmdir($dir) : true;
}

// 使用
rrmdir('/tmp/cache');           // 刪除整個目錄
rrmdir('/var/www/uploads', false); // 僅清空內容,保留目錄

關鍵設計點

  • CHILD_FIRST:深度優先、子目錄先於父目錄刪除,避免「目錄非空」錯誤
  • SKIP_DOTS:自動跳過 . ..
  • isLink() 優先 unlink():避免追蹤符號連結刪除到目標真實檔案
  • @ 抑制警告:權限不足時繼續處理其他檔案,最終回傳整體結果

進階:權限修正後再刪(處理 root 建立的檔案)

function rrmdirForce(string $dir, bool $self = true): bool
{
    $dir = rtrim($dir, '/\\');
    if (!is_dir($dir)) return false;

    // 嘗試修正權限(需執行者有 sudo 或為檔案擁有者)
    $iterator = new RecursiveIteratorIterator(
        new RecursiveDirectoryIterator($dir, FilesystemIterator::SKIP_DOTS),
        RecursiveIteratorIterator::CHILD_FIRST
    );
    foreach ($iterator as $item) {
        @chmod($item->getPathname(), 0777);
    }
    @chmod($dir, 0777);

    return rrmdir($dir, $self);
}

Symfony Filesystem / Laravel File 封裝

// Symfony
use Symfony\Component\Filesystem\Filesystem;
$fs = new Filesystem();
$fs->remove('/tmp/cache'); // 內建遞迴、例外處理

// Laravel
use Illuminate\Support\Facades\File;
File::deleteDirectory('/tmp/cache');

效能提示

  • 超大目錄(>10萬檔)建議分批、非同步處理,避免 PHP 超時
  • SSD 上 unlink 极快,HDD 可考慮 exec('rm -rf ' . escapeshellarg($dir))(需極謹慎)
copyright © 萬盛學電腦網 all rights reserved