一、基本介绍

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

PHP mkdir()