深入解析 PHP is_writable 函數的自定義實現原理

PHP 內建的 is_writable() 函數雖然方便，但在某些特殊場景（如權限判斷不準確、掛載點檢測等）下可能無法滿足需求。本文提供一個功能完整的替代實現 isWritable()，並詳細解析其核心邏輯與邊界處理。

核心實現代碼

function isWritable($filename) {
    // 1. 處理目錄路徑：若以 / 結尾，視為目錄，嘗試建立臨時文件測試
    if (preg_match('/\/$/', $filename)) {
        $tmp_file = sprintf('%s%s.tmp', $filename, uniqid(mt_rand()));
        return isWritable($tmp_file); // 遞歸調用檢測目錄可寫性
    }

    // 2. 文件已存在：嘗試以 "r+" 模式打開（讀寫模式，指針在開頭）
    if (file_exists($filename)) {
        $fp = @fopen($filename, 'r+');
        if ($fp) {
            fclose($fp);
            return true;
        }
        return false;
    }

    // 3. 文件不存在：嘗試以 "w" 模式創建新文件
    $fp = @fopen($filename, 'w');
    if ($fp) {
        fclose($fp);
        unlink($filename); // 測試成功後立即刪除臨時文件
        return true;
    }
    return false;
}

關鍵邏輯解析

目錄判斷與遞歸測試

當路徑以 / 結尾時，視為目錄。通過生成唯一臨時文件名（uniqid(mt_rand()) 保證唯一性），遞歸調用自身測試目錄是否可寫。這比單純檢查權限位更可靠，因為它實際嘗試了文件系統操作。

既存文件的讀寫驗證

使用 fopen($filename, 'r+') 而非 'w' 或 'a'，原因在於：

• r+：以讀寫模式打開，文件指針置於開頭，**不會截斷文件內容**
• w：會清空文件內容，破壞原有數據
• a：指針置於結尾，無法驗證文件開頭可寫性

若打開成功即關閉句柄返回 true，失敗返回 false。

新文件創建測試

對於不存在的路徑，嘗試以 w 模式創建。成功後立即 fclose() 並 unlink() 刪除，避免留下垃圾文件。這模擬了實際寫入場景，包含目錄權限、磁盤空間、inode 限制等所有約束條件。

優勢與適用場景

• 實際操作驗證：比單純檢查 fileperms() 更準確，繞過 ACL、SELinux 等複雜權限系統的誤判
• 跨平台兼容：Windows/Linux/Unix 均可正常工作
• 邊界情況處理：正確處理目錄、既存文件、新文件三種場景

注意事項

雖然此實現較健壯，但須注意：

1. 頻繁調用可能產生大量系統調用，高併發場景建議緩存結果
2. 測試過程會實際創建/打開文件，極端情況下可能觸發磁盤 IO 瓶頸
3. 對於只讀文件系統、配額已滿等情況能正確返回 false

此實現可作為 is_writable() 的可靠補充，特別適合需要精確判斷寫入權限的文件上傳、緩存系統、日誌輪轉等場景。