萬盛學電腦網

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

PHP 文件刪除實戰:unlink()、rmdir() 與安全檢查完整指南

PHP 檔案系統刪除操作核心函數

PHP 提供 unlink() 刪除檔案、rmdir() 刪除目錄。本文系統講解參數、返回值、錯誤處理、安全檢查與實戰模式。

unlink():刪除檔案

函數簽名

unlink(string $filename, ?resource $context = null): bool

基本用法

<?php
// 簡單刪除
unlink("test.txt");  // 成功返回 true,失敗 false

// 變數路徑
$file = "test.txt";
unlink($file);
?>

完整錯誤處理模式

<?php
$file = "test.txt";

if (unlink($file)) {
    echo "檔案 $file 刪除成功!";
} else {
    echo "檔案 $file 刪除失敗!";
    // 可檢查 error_get_last() 獲取詳細錯誤
}
?>

進階:存在性檢查 + 刪除

<?php
$myfile = "./test1.txt";

if (file_exists($myfile)) {
    $result = unlink($myfile);
    echo $result ? "刪除成功" : "刪除失敗: " . error_get_last()['message'];
} else {
    echo "檔案不存在: $myfile";
}
?>

批量刪除模式

<?php
function deleteFiles(array $patterns): array {
    $results = [];
    foreach ($patterns as $pattern) {
        $files = glob($pattern);
        foreach ($files as $file) {
            if (is_file($file)) {
                $results[$file] = unlink($file);
            }
        }
    }
    return $results;
}

// 刪除所有 .tmp 和 .log 檔案
$results = deleteFiles(['*.tmp', '*.log', 'cache/*']);
print_r($results);
?>

rmdir():刪除空目錄

函數簽名

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

限制條件

  • 目錄必須為空:包含檔案/子目錄會失敗
  • 需具備寫入權限
  • 非遞歸刪除

基本範例

<?php
$dirname = 'testdir';

if (rmdir($dirname)) {
    echo "目錄 $dirname 刪除成功";
} else {
    echo "目錄 $dirname 刪除失敗: " . error_get_last()['message'];
}
?>

遞歸刪除目錄樹:完整實現

<?php
function deleteDirectory(string $dir): bool {
    if (!is_dir($dir)) {
        return false;
    }
    
    $items = scandir($dir);
    foreach ($items as $item) {
        if ($item === '.' || $item === '..') continue;
        
        $path = $dir . DIRECTORY_SEPARATOR . $item;
        
        if (is_dir($path)) {
            deleteDirectory($path);  // 遞歸刪除子目錄
        } else {
            unlink($path);           // 刪除檔案
        }
    }
    
    return rmdir($dir);  // 最後刪除空目錄
}

// 使用
deleteDirectory('/path/to/directory');
?>

現代替代:RecursiveDirectoryIterator (PHP 5.3+)

<?php
function deleteDirectoryModern(string $dir): void {
    $files = new RecursiveIteratorIterator(
        new RecursiveDirectoryIterator($dir, RecursiveDirectoryIterator::SKIP_DOTS),
        RecursiveIteratorIterator::CHILD_FIRST  // 先刪除子項
    );
    
    foreach ($files as $file) {
        if ($file->isDir()) {
            rmdir($file->getPathname());
        } else {
            unlink($file->getPathname());
        }
    }
    rmdir($dir);
}
?>

安全檢查清單(生產環境必備)

  1. 路徑遍歷防護:
    <?php
    function safeDelete(string $userInput, string $baseDir): bool {
        // 解析真實路徑
        $realBase = realpath($baseDir);
        $realTarget = realpath($baseDir . DIRECTORY_SEPARATOR . $userInput);
        
        // 確保目標在基礎目錄內
        if ($realTarget === false || strpos($realTarget, $realBase) !== 0) {
            throw new Exception("非法路徑訪問: $userInput");
        }
        
        return is_file($realTarget) ? unlink($realTarget) : deleteDirectory($realTarget);
    }
    ?>
  2. 權限檢查:
    if (!is_writable($file)) {
        throw new Exception("無寫入權限: $file");
    }
  3. 鎖定機制:併發環境下使用 flock() 或資料庫鎖防止競態刪除
  4. 審計日誌:記錄刪除操作(用戶、時間、檔案、結果)
  5. 軟刪除模式:移至回收目錄而非物理刪除,支援恢復

錯誤代碼對照表

錯誤常數值含義
E_WARNING2unlink/rmdir 失敗時觸發(權限、不存在、目錄非空)
ENOENT2檔案/目錄不存在
EACCES13權限拒絕
ENOTEMPTY39目錄非空
EISDIR21對目錄使用 unlink()

效能與最佳實踐

  • 大量檔案刪除:考慮 exec('rm -rf ...') (需極度謹慎、輸入消毒) 或背景任務隊列
  • 避免在循環中 clearstatcache():unlink() 會自動清除快取,但 file_exists() 多次調用需手動清除
  • 使用 SplFileObject:物件導向檔案操作,自動資源管理
  • 臨時檔案自動清理:tmpfile() 創建的臨時檔案,關閉句柄或腳本結束自動刪除

總結

  • unlink() 刪除檔案,rmdir() 刪除空目錄
  • 刪除前必須驗證路徑安全性,防止路徑遍歷攻擊
  • 目錄樹刪除用 RecursiveDirectoryIterator::CHILD_FIRST 遞歸模式
  • 生產環境實施軟刪除+審計日誌+權限檢查三重保障
  • PHP 8.2+ 動態屬性棄用,檔案操作類建議显式宣告屬性
copyright © 萬盛學電腦網 all rights reserved