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

允许递归创建由 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($structure0777true)) {
    die(
'Failed to create folders...');
}

// ...
?>

错误/异常

目录已存在时,产生 E_WARNING错误。

如果因为权限问题无法创建目录,导致 E_WARNING错误。

参见

  • is_dir() - 判断给定文件名是否是一个目录
  • rmdir() - 删除目录