mkdir

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

mkdir新建目錄

說明

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

嘗試新建一個(gè)由 pathname 指定的目錄。

參數(shù)

pathname

目錄的路徑。

mode

默認(rèn)的 mode 是 0777,意味著最大可能的訪問權(quán)。有關(guān) mode 的更多信息請(qǐng)閱讀 chmod() 頁面。

注意:

mode 在 Windows 下被忽略。

注意也許想用八進(jìn)制數(shù)指定模式,也就是說該數(shù)應(yīng)以零打頭。模式也會(huì)被當(dāng)前的 umask 修改,可以用 umask() 來改變。

recursive

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

context

上下文流(context stream) resource。

返回值

成功時(shí)返回 true, 或者在失敗時(shí)返回 false

范例

示例 #1 mkdir() 例子

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

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

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

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

if (!mkdir($structure0777true)) {
    die(
'Failed to create folders...');
}

// ...
?>

錯(cuò)誤/異常

目錄已存在時(shí),產(chǎn)生 E_WARNING錯(cuò)誤。

如果因?yàn)闄?quán)限問題無法創(chuàng)建目錄,導(dǎo)致 E_WARNING錯(cuò)誤。

參見

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