萬盛學電腦網

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

PHP unlink 刪除檔案失敗常見原因與解決方案

錯誤現象分析

Warning: unlink(user_logo/d4d84f383714d5f3.jpg) [function.unlink]: No such file or directory

關鍵線索:路徑中出現  — 這是 **UTF-8 BOM (Byte Order Mark, EF BB BF)** 的 HTML 實體編碼顯示,表示檔名實際以 BOM 開頭,導致路徑不匹配。

根因排查清單

  1. BOM 污染:資料庫欄位儲存的檔名含 BOM (常見於 Excel 匯入、Windows 記事本儲存 CSV)。
  2. 路徑拼接錯誤:目錄分隔符、相對/絕對路徑不一致、末尾斜線重複或缺失。
  3. 權限不足:PHP 進程用戶無目錄寫入/執行權限。
  4. 檔案不存在:已被刪除、路徑錯誤、大小寫敏感 (Linux)。
  5. 檔案被佔用:Windows 下檔案被其他進程開啟無法刪除。

完整解決方案

1. 移除 BOM 與清理檔名

<?php
function cleanFilename(string $filename): string
{
    // 移除 UTF-8 BOM
    $filename = preg_replace('/^\xEF\xBB\xBF/', '', $filename);
    // 移除其他不可見控制字符
    $filename = preg_replace('/[\x00-\x1F\x7F]/', '', $filename);
    // 正規化路徑分隔符
    $filename = str_replace('\\', '/', $filename);
    return $filename;
}

// 使用
$fn = cleanFilename($rs['abc']); // 從資料庫讀取
$fullPath = __DIR__ . '/user_logo/' . $fn;

if (file_exists($fullPath)) {
    if (unlink($fullPath)) {
        echo "刪除成功";
    } else {
        echo "刪除失敗 (權限/鎖定)";
    }
} else {
    echo "檔案不存在: $fullPath";
    // 除錯:列出目錄實際檔案
    print_r(glob(__DIR__ . '/user_logo/*'));
}

2. 安全刪除封裝函數

<?php
/**
 * 安全刪除檔案
 * @param string $path 檔案路徑 (相對或絕對)
 * @param bool   $useRealpath 是否解析真實路徑 (解決符號鏈接、相對路徑問題)
 * @return array ['success'=>bool, 'message'=>string]
 */
function safeUnlink(string $path, bool $useRealpath = true): array
{
    $resolved = $useRealpath ? realpath($path) : $path;
    
    if ($resolved === false || !is_file($resolved)) {
        return ['success' => false, 'message' => "檔案不存在: $path"];
    }

    if (!is_writable($resolved)) {
        return ['success' => false, 'message' => "無寫入權限: $resolved"];
    }

    // Windows 下嘗試釋放可能的鎖定
    if (strtoupper(substr(PHP_OS, 0, 3)) === 'WIN') {
        // 可嘗試關閉已知句柄,或延遲重試
        clearstatcache(true, $resolved);
    }

    if (@unlink($resolved)) {
        return ['success' => true, 'message' => '刪除成功'];
    }

    $error = error_get_last();
    return ['success' => false, 'message' => "刪除失敗: " . ($error['message'] ?? '未知錯誤')];
}

// 使用
$result = safeUnlink("user_logo/{$rs['abc']}");
if (!$result['success']) {
    error_log("刪除失敗: {$result['message']}");
}

3. 資料庫層面預防

-- 匯入/寫入前清理
UPDATE your_table SET abc = TRIM(REPLACE(REPLACE(abc, CHAR(0xEF), ''), CHAR(0xBB), ''))
-- 或應用層寫入前
$cleanName = cleanFilename($_FILES['file']['name']);
// 存入資料庫

除錯技巧

<?php
// 1. 顯示實際位元組
$fn = $rs['abc'];
echo '原始長度: ' . strlen($fn) . '
'; echo 'Hex: ' . bin2hex($fn) . '
'; // 若開頭 ef bb bf 即為 BOM // 2. 列出目錄實際檔案對比 $dir = 'user_logo/'; foreach (scandir($dir) as $f) { if ($f !== '.' && $f !== '..') { echo "$f (len=" . strlen($f) . ")
"; } }

總結檢查單

  • [ ] 檔名是否含 BOM/控制字符 → cleanFilename()
  • [ ] 路徑是否正確 (相對/絕對、分隔符) → realpath() 驗證
  • [ ] 檔案是否存在 → file_exists() / is_file()
  • [ ] 權限是否足夠 → is_writable()、目錄 x 權限
  • [ ] Windows 鎖定 → 延遲重試 / 重啟 PHP-FPM / 使用 Handle.exe 排查

90% 的 unlink 失敗源於「路徑不匹配」(含 BOM、大小寫、分隔符),徹底清理輸入路徑即可解決。

copyright © 萬盛學電腦網 all rights reserved