mkdir

(PHP 4, PHP 5, PHP 7, PHP 8)

mkdir — 新建目錄

說明

mkdir(
    string $pathname,
    int $mode = 0777,
    bool $recursive = false,
    resource $context = ?
): bool

嘗試新建一個由 pathname 指定的目錄。

參數

pathname

目錄的路徑。

mode

默認的 mode 是 0777，意味著最大可能的訪問權。有關 mode 的更多信息請閱讀 chmod() 頁面。

注意:

mode 在 Windows 下被忽略。

注意也許想用八進制數指定模式，也就是說該數應以零打頭。模式也會被當前的 umask 修改，可以用 umask() 來改變。

recursive

允許遞歸創(chuàng)建由 pathname 所指定的多級嵌套目錄。

context

上下文流（context stream） resource。

返回值

成功時返回 true， 或者在失敗時返回 false。

范例

示例 #1 mkdir() 例子

<?php
mkdir("/path/to/my/dir", 0700);
?>

示例 #2 通過 recursive 參數使用 mkdir()

<?php
// Desired folder structure
$structure = './depth1/depth2/depth3/';

// To create the nested structure, the $recursive parameter 
// to mkdir() must be specified.

if (!mkdir($structure, 0777, true)) {
    die('Failed to create folders...');
}

// ...
?>

錯誤／異常

目錄已存在時，產生 E_WARNING錯誤。

如果因為權限問題無法創(chuàng)建目錄，導致 E_WARNING錯誤。

參見

  • is_dir() - 判斷給定文件名是否是一個目錄
  • rmdir() - 刪除目錄