• <pre id="9qgxl"></pre>

    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() - 刪除目錄