Php/docs/function.mkdir
mkdir
(PHP 4, PHP 5, PHP 7)
mkdir — 新建目录
说明
mkdir
( string $pathname
[, int $mode
= 0777
[, bool $recursive
= false
[, resource $context
]]] ) : bool
尝试新建一个由 pathname 指定的目录。
参数
pathname
目录的路径。
mode
默认的 mode 是 0777,意味着最大可能的访问权。有关 mode 的更多信息请阅读 chmod() 页面。
Note:
mode
在 Windows 下被忽略。注意也许想用八进制数指定模式,也就是说该数应以零打头。模式也会被当前的 umask 修改,可以用 umask() 来改变。
recursive
允许递归创建由
pathname
所指定的多级嵌套目录。context
Note: 在 PHP 5.0.0
中增加了对上下文(Context)的支持。有关
上下文(Context)
的说明参见
返回值
成功时返回 true
, 或者在失败时返回 false
。
范例
Example #1 mkdir() 例子
<?phpmkdir("/path/to/my/dir", 0700);?>
Example #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
错误。