您的位置:

PHP mkdir()

一、基本介绍

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);
        }
    }