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";
}
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);
| 錯誤 | 原因 | 解決 |
|---|---|---|
| Permission denied | 父目錄無執行權限或擁有者不匹配 | chown/chmod父目錄,或調整PHP-FPM運行用戶 |
| File exists | 同名文件存在(非目錄) | 檢查is_dir()、file_exists()區分 |
| No such file or directory | recursive=false且父目錄不存在 | 設置recursive=true |