PHP Conference Japan 2024

    mkdir

    (PHP 4, PHP 5, PHP 7, PHP 8)

    mkdir — 创建目录

    描述

    mkdir(
        字符串 $directory,
        整数 $permissions = 0777,
        布尔值 $recursive = false,
        ?资源 $context = null
    ): 布尔值

    尝试创建由 directory 指定的目录。

    参数

    directory

    目录路径。

    提示

    如果启用了 fopen 封装器，则可以使用 URL 作为此函数的文件名。有关如何指定文件名的更多详细信息，请参阅 fopen()。有关各个封装器具有的功能、使用说明以及它们可能提供的任何预定义变量的信息，请参阅 支持的协议和封装器。

    permissions

    权限默认为 0777，这意味着最广泛的访问权限。有关权限的更多信息，请阅读 chmod() 页面的详细信息。

    注意:

    在 Windows 上忽略 permissions。

    请注意，您可能希望将 permissions 指定为八进制数，这意味着它应该以零开头。permissions 还会受当前 umask 的修改，您可以使用 umask() 更改它。

    recursive

    如果为 true，则还会创建指定 directory 的任何父目录，并具有相同的权限。

    context

    一个 上下文流 资源。

    返回值

    成功时返回 true，失败时返回 false。

    注意:

    如果要创建的目录已存在，则将其视为错误，并且仍将返回 false。在尝试创建目录之前，请使用 is_dir() 或 file_exists() 检查目录是否已存在。

    错误/异常

    如果目录已存在，则发出 E_WARNING 级别的错误。

    如果相关权限阻止创建目录，则发出 E_WARNING 级别的错误。

    示例

    示例 #1 mkdir() 示例

    <?php
    mkdir    ("/path/to/my/dir", 0700);
    ?>

    示例 #2 使用 recursive 参数的 mkdir()

    <?php
    // 期望的目录结构
    $structure = './depth1/depth2/depth3/';

    // 要创建嵌套结构，必须指定 mkdir() 的 $recursive 参数。

    if (!mkdir($structure, 0777, true)) {
    die(    '创建目录失败...');
    }

    // ...
    ?>

    参见

    发现问题？

    了解如何改进此页面 • 提交拉取请求 • 报告错误
    ＋添加注释

    用户贡献的注释 5 条注释

    35
    jack dot sleight at gmail dot com
    14 年前
    在使用 recursive 参数时，请记住，如果您在 mkdir() 之后使用 chmod() 来设置模式，而没有被 uchar() 的值修改，则需要对所有创建的目录调用 chmod()。例如

    <?php
    mkdir    ('/test1/test2', 0777, true);
    chmod('/test1/test2', 0777);
    ?>

    可能会导致 "/test1/test2" 的模式为 0777，但 "/test1" 仍然具有来自 mkdir() 调用的 0755 模式。您需要执行以下操作

    <?php
    mkdir    ('/test1/test2', 0777, true);
    chmod('/test1', 0777);
    chmod('/test1/test2', 0777);
    ?>
    19
    aulbach at unter dot franken dot de
    25 年前
    这是 Stig Bakken 的注释

    目录上的模式受当前 umask 的影响。它将
    最终具有 (<mkdir-mode> 和 (not <umask>))。如果您想创建一个
    公开可读的，请执行以下操作

    <?php
    $oldumask     = umask(0);
    mkdir('mydir', 0777); // 或者 01777 以便设置粘滞位
    umask($oldumask);
    ?>
    6
    Protik Mukherjee
    19 年前
    mkdir、文件读写、Fedora 3 的权限相关注释////
    如果您使用的是 Fedora 3 并且遇到权限问题，最好检查您的系统上是否启用了 SElinux。它添加了额外的安全层，因此即使 PHP 具有 777 权限，也无法写入文件夹。我花了将近一周的时间来处理这个问题！

    如果您不确定，请搜索 SElinux 或“禁用 SELinux”，这可能是解决方法！祝您好运！
    3
    julius - grantzau - c-o-m
    13 年前
    记住要使用 clearstatcache()

    ...在处理文件系统函数时。

    否则，例如，您可能会在删除文件夹（使用 rmdir）后立即创建文件夹（使用 mkdir）时出错。
    -1
    chelidze dot givia at gmail dot com
    1 年前
    使用 mkdir() 创建文件时，默认根目录将是 DocumentRoot（在 XAMPP 中）本身。

    C:\xampp\htdocs\project/includes/something.php

    如果您在 something.php 中使用 mkdir("myfile")，php 不会在 includes 中创建文件夹，而是在 project 文件夹中创建它
    ＋添加注释
    To Top