PHP 遞歸建立多層目錄函數 mk_dir 實作與原理解析

前言

PHP mkdir() 預設不支援遞歸建立多層目錄（PHP 5.0+ 第三參數 $recursive 才支援），舊專案或特定環境常需自行實作。本文解析 ThinkPHP 來源的 mk_dir 遞歸建目函數，說明邏輯流程、潛在問題與現代替代方案。

原始實作程式碼

function mk_dir($dir, $mode = 0777) {
    if (!is_dir($dir) || mkdir($dir, $mode)) {
        if (!mk_dir(dirname($dir), $mode)) {
            return false;
        }
    }
    return mkdir($dir, $mode);
}

邏輯流程分析

1. 終止條件：is_dir($dir) 為真（目錄已存在）或 mkdir() 成功建立。
2. 遞歸步驟：呼叫 dirname($dir) 取得父目錄，遞歸建立父目錄。
3. 回傳值：最終對目標目錄執行 mkdir() 並回傳結果。

潛在問題與風險

改良版：加入根目錄守衛與錯誤處理

function mk_dir_improved($dir, $mode = 0777) {
    // 正規化路徑
    $dir = rtrim($dir, '/');
    if ($dir === '' || $dir === '/') return true;  // 根目錄守衛

    if (is_dir($dir)) return true;

    $parent = dirname($dir);
    if ($parent !== $dir) {  // 避免根目錄無限遞歸
        if (!mk_dir_improved($parent, $mode)) {
            return false;
        }
    }

    // 建立目錄並處理競態條件
    if (!mkdir($dir, $mode)) {
        // 最後再確認一次是否已存在（可能被其他程序建立）
        return is_dir($dir);
    }
    return true;
}

現代 PHP 最佳實踐（PHP 5.0+）

// 內建遞歸參數，簡潔高效
mkdir('/path/to/deep/dir', 0777, true);

優勢：C 層實作、原子性較好、無需自維護遞歸邏輯、支援所有平台。

總結

理解遞歸建目邏輯有助於維護舊代碼，但**新專案請直接使用 mkdir($path, $mode, true)**。若必須自行實作，務必加入根目錄守衛、競態條件處理與權限檢查，避免生產環境異常。

1. 上一篇文章： PHP 判斷字串是否為合法 JSON 格式的最佳實踐
2. 下一篇文章： 常用正則表達式集合：URL、Email、電話、整數驗證

PHP 相關知識

基於 Swoole 實現 PHP WebSocket 聊天室完整教學

WebSocket vs HTTP vs 輪詢 特性H

用 Composer 打造專屬 PHP 框架（四）：整合 Laravel Eloquent ORM 完成框架雛形

用 Composer 打造專屬 PHP 框架（四）：整合 L

PHP 檔案上傳、下載、刪除完整實作：從表單構建到安全加固的工程級指南

系統架構圖 ┌─────────────┐ ┌───

打造專屬微博系統：PHP + MySQL + jQuery 即時字數統計與 Ajax 發布

專案概覽 參考 QQ 個人中心、新浪微博的「說說」功能，實作