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

• 注意: 在 PHP 5.0.0 中增加了对上下文（Context）的支持。有关上下文（Context）的说明参见 Streams。

返回值

成功时返回 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() - 删除目录