萬盛學電腦網

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

PHP 多層目錄遞迴建立函數:mkdir 遞迴模式與手動實作比較

現代最簡寫法:mkdir 遞迴參數(PHP 5.0+)

<?php
// 一行搞定:第三參數 true 啟用遞迴建立
mkdir('/path/to/deep/nested/dir', 0755, true);

// 完整錯誤處理版
function make_directory($path, $mode = 0755) {
    // 統一路徑分隔符
    $path = str_replace('\\', '/', $path);
    
    if (is_dir($path)) return true;  // 已存在
    
    // 遞迴建立,抑制警告自行處理錯誤
    if (@mkdir($path, $mode, true)) {
        return true;
    }
    
    // 失敗時檢查具體原因
    $error = error_get_last();
    throw new RuntimeException("無法建立目錄 '$path': " . $error['message']);
}

手動遞迴實作(理解原理/舊版相容)

原文提供的手動分層建立邏輯:

function makedirectory($directoryname) {
    $directoryname = str_replace('\\', '/', $directoryname);
    $dirnames = explode('/', $directoryname);
    $total = count($dirnames);
    $temp = '';
    
    for ($i = 0; $i < $total; $i++) {
        $temp .= $dirnames[$i] . '/';
        if (!is_dir($temp)) {
            $oldmask = umask(0);          // 暫時移除 umask 限制
            if (!mkdir($temp, 0777)) {    // 建立單層
                umask($oldmask);
                exit("不能建立目錄 $temp");
            }
            umask($oldmask);              // 還原 umask
        }
    }
    return true;
}

umask 權限遮罩詳解

  • umask(0):暫時關閉權限遮罩,確保 `mkdir($path, 0777)` 真正給 0777 權限
  • 實際權限 = `mode & ~umask`,預設 umask 通常為 0022(導致 0777 變 0755)
  • 建立完成後**必須還原** `umask($oldmask)`,避免影響後續檔案操作

現代最佳實踐:結合雙重保險

function ensure_dir($path, $mode = 0755) {
    // 1. 正規化路徑
    $path = rtrim(str_replace('\\', '/', $path), '/');
    
    // 2. 已存在直接返回
    if (is_dir($path)) return true;
    
    // 3. 父目錄不存在時遞迴建立(PHP 原生遞迴)
    $parent = dirname($path);
    if (!is_dir($parent)) {
        ensure_dir($parent, $mode);
    }
    
    // 4. 建立當前層,處理競態條件(並發建立同目錄)
    @mkdir($path, $mode);
    if (!is_dir($path)) {
        // 可能被其他程序同時建立完成,或權限不足
        throw new RuntimeException("建立目錄失敗: $path");
    }
    
    // 5. 確保權限正確(某些檔案系統需額外 chmod)
    @chmod($path, $mode);
    return true;
}

常見應用場景

上傳檔案自動建立日期目錄

function get_upload_dir($base = '/var/www/uploads') {
    $date = date('Y/m/d');
    $dir = "$base/$date";
    ensure_dir($dir);
    return $dir;
}

// 使用
$upload_dir = get_upload_dir();
$target = $upload_dir . '/' . uniqid() . '_' . basename($_FILES['file']['name']);
move_uploaded_file($_FILES['file']['tmp_name'], $target);

快取目錄結構建立

function get_cache_path($key) {
    // 以 key 前兩字元分層,避免單目錄檔案過多
    $prefix = substr(md5($key), 0, 2);
    $dir = "/tmp/cache/$prefix";
    ensure_dir($dir);
    return "$dir/$key.cache";
}

Windows 路徑注意事項

  • PHP 內部統一用 `/`,Windows 也支援
  • 避免在路徑中使用保留字元:`< > : " | ? *`
  • 網路路徑:`//server/share/path` 或 `\\server\share\path`

權限設定建議

copyright © 萬盛學電腦網 all rights reserved
場景建議模式說明
Web 可寫入目錄0755擁有者寫入,群組/其他讀取執行
上傳/快取目錄0775群組也可寫入(需設定正確群組)
私密資料目錄0700僅擁有者可存取