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($structure, 0777, true)) {
    die('Failed to create folders...');
}

// ...
?>

错误／异常

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

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

参见

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