PHP is_writable 函數詳解與自定義替代實現

is_writable() 用於判斷文件或目錄是否可寫，但其結果會被緩存，且受運行用戶權限影響。本文詳細講解函數行為、常見坑點，並提供一個不依賴緩存的自定義替代實現。

函數原型與行為

bool is_writable(string $filename)

• 返回 true：文件/目錄存在且當前進程用戶有寫權限
• 返回 false：不存在、不可寫、或權限不足
• 緩存機制：結果被 PHP 內部緩存，調用 clearstatcache() 可清除
• 用戶上下文：通常以 Web Server 用戶（如 www-data、nobody）運行，非 CLI 用戶
• 目錄判斷：參數為目錄時，判斷是否可在該目錄創建文件

常見誤區示例

<?php 
$filename = "test.txt"; 
if (is_writable($filename)) { 
    echo "可寫"; 
} else { 
    echo "不可寫"; // 可能因緩存導致誤判 
} 
// 正確做法： 
clearstatcache(); 
if (is_writable($filename)) { ... }

自定義替代實現（無緩存、更直觀）

/** 
 * 判斷文件/目錄是否可寫（不依賴 stat 緩存） 
 * @param string $path 
 * @return bool 
 */ 
function isWritable($path) { 
    // 目錄：嘗試創建臨時文件 
    if (preg_match('/\/$/', $path)) { 
        $tmp = $path . uniqid(mt_rand()) . '.tmp'; 
        return isWritable($tmp); // 遞歸調用文件邏輯 
    } 
    
    if (file_exists($path)) { 
        // 文件存在：嘗試以 r+ 模式打開（讀寫不截斷） 
        $fp = @fopen($path, 'r+'); 
        if ($fp) { fclose($fp); return true; } 
        return false; 
    } else { 
        // 文件不存在：嘗試創建 
        $fp = @fopen($path, 'w'); 
        if ($fp) { 
            fclose($fp); 
            @unlink($path); // 清理測試文件 
            return true; 
        } 
        return false; 
    } 
}

對比與選擇建議

最佳實踐

1. 文件操作前調用 clearstatcache(true, $path)（PHP 5.3+ 支持指定路徑清除）
2. 關鍵寫入操作採用「嘗試寫入捕獲異常」模式，而非預判
3. 部署腳本中包含權限檢查步驟，確保 www-data 對存儲目錄有 rwx
4. 使用 is_dir() + is_writable() 組合判斷目錄可寫

理解 is_writable 的緩存特性與用戶上下文，結合自定義實現靈活應對，能避免大量「明明有權限卻判斷失敗」的坑。