一、基本介绍
mkdir() 函数在指定的路径创建一个新目录。
该函数的基本语法如下:
bool mkdir ( string $pathname [, int $mode = 0777 [, bool $recursive = false [, resource $context ]]] )
参数解释:
- pathname: 必选参数,规定要创建目录的路径。
- mode: 可选参数,规定目录的权限。默认是 0777,意味所有用户都有完全的访问权限。
- recursive: 可选参数,规定是否设置递归属性。默认为 false。
- context: 可选参数,规定文件句柄的环境。
二、使用方法
1. 创建一个新目录
下面这个例子演示了,在当前目录创建一个名为 "test" 的新目录:
if(!is_dir("test")){ mkdir("test"); }
2. 设置权限
默认情况下,所有用户都有完全的读、写、执行权限。
但是,为了更加安全,您应该尽可能的限制访问权限。通过传递一个 mode 参数来完成这个任务。
下面这个例子,创建一个新目录 "test",而且设置了权限为 0755:
if(!is_dir("test")){ mkdir("test",0755); }
3. 创建多级目录
如果要在指定目录的新目录中创建子目录,可以将 recursive 参数设置为 true。
下面这个例子将在 "test" 目录中创建多级子目录 "demo1/demo2/demo3":
$dir="./test/demo1/demo2/demo3"; if(!file_exists($dir)){ mkdir($dir,0777,true); }
4. 创建目录上下文
了解上下文选项的作用,请参阅下面这个例子,它为 mkdir() 创建一个新的目录上下文:
//设置上下文选项 $context=stream_context_create(array( 'http'=>array( 'method'=>'GET' ) )); if(!file_exists($dir)){ mkdir($dir,0777,true,$context); }
三、错误处理
mkdir() 遇到错误时会返回 false,并返回一个错误。
下面的例子演示了当试图在不存在的目录中创建一个新的目录时,系统返回的错误:
if(!file_exists("test")){ mkdir("test/demo1/demo2/demo3",0777,true); } else{ echo("The name already exists."); }
如果您的 PHP 版本低于 5.2.0,则无法使用递归属性。在这种情况下,您可以使用下面这个例子中的自定义函数来模仿递归属性:
function createFolder($folderPath){ if (!file_exists($folderPath)){ createFolder(dirname($folderPath)); mkdir($folderPath, 0777); } }