萬盛學電腦網

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

PHP創建目錄:mkdir()函數詳解、遞歸創建、權限控制與競態條件處理

mkdir()是PHP創建目錄的核心函數。本文涵蓋基本語法、遞歸創建多級目錄、權限設置、原子性競態條件避免及常見錯誤處理。

基本語法

mkdir(string $directory, int $permissions = 0777, bool $recursive = false, resource $context = null): bool
  • $permissions:八進制權限(如0755),受umask影響,最終權限 = permissions & ~umask。
  • $recursive:true時自動創建父目錄(PHP 5.0.0+)。

安全創建模式

function create_dir_secure(string $path, int $mode = 0755): bool {
    // 1. 規範化路徑
    $path = rtrim($path, '/\\');
    // 2. 避免競態:先檢查再創建不可靠,直接嘗試創建並捕獲錯誤
    if (@mkdir($path, $mode, true)) {
        return true;
    }
    // 3. 失敗時二次確認(可能並發已創建)
    return is_dir($path) && is_writable($path);
}

// 使用
if (create_dir_secure('/var/www/uploads/2024/05')) {
    echo "目錄就緒\n";
}

權限最佳實踐

  • Web目錄:0755(擁有者讀寫執行,組/其他讀執行)。
  • 上傳/緩存目錄:0775或0770(確保PHP-FPM用戶組有寫權限)。
  • 避免0777:任何用戶可寫入,極大安全風險。

上下文支持(流包裝器)

// FTP創建遠程目錄
$ctx = stream_context_create(['ftp' => ['overwrite' => false]]);
mkdir('ftp://user:pass@ftp.example.com/public_html/newdir', 0755, true, $ctx);

常見錯誤與排查

正確使用mkdir()配合權限管理,是構建可靠文件存儲服務的基礎。

copyright © 萬盛學電腦網 all rights reserved
錯誤原因解決
Permission denied父目錄無執行權限或擁有者不匹配chown/chmod父目錄,或調整PHP-FPM運行用戶
File exists同名文件存在(非目錄)檢查is_dir()、file_exists()區分
No such file or directoryrecursive=false且父目錄不存在設置recursive=true