PHP 如何创建目录

在日常做网站或小程序开发时，你肯定遇过需要让程序自动生成文件夹的情况——比如用户上传头像，得建个专属文件夹存文件；或者搞个博客系统，按年份归档文章，得每年建个新目录。要是手动建文件夹，不仅麻烦，用户多的时候根本忙不过来，用PHP就能轻松搞定这些事。

先搞懂：PHP建目录的核心函数

PHP里专门用来建目录的函数叫mkdir()，就像手机里的“新建文件夹”按钮，但它是给程序用的。这个函数有两个关键参数，像填快递单一样：第一个是要建的文件夹路径，第二个是权限（普通用户不用太纠结，填0755就行，相当于给文件夹设好安全规则）。

举个生活化的例子：你想在电脑桌面建个叫“2024旅行照片”的文件夹，路径就是C:\Users\你的名字\Desktop\2024旅行照片，对应到PHP里，就是把这个路径写进mkdir()的第一个参数。

最基础的创建：一步搞定简单目录

如果只是建单个简单的文件夹，直接用mkdir()就行，代码很短，新手也能看懂。比如你要在网站根目录建一个“user_upload”文件夹存用户文件，代码可以这么写：

`php

// 定义要建的文件夹路径，这里是网站根目录下的user_upload

$dir = './user_upload';

// 用mkdir函数创建，0755是固定权限设置

if (mkdir($dir, 0755)) {

echo "文件夹创建成功！";

} else {

echo "文件夹创建失败，可能是权限不够哦~";

}

`

这里的./代表当前网站的根目录，就像你打开电脑的“此电脑”直接找桌面一样。加个判断是怕程序没权限建文件夹，比如服务器不让随便改根目录，这时候就会返回失败，方便排查问题。

进阶场景：建多层嵌套目录

有时候需要建嵌套文件夹，比如“2024/08/旅行照片”，要是直接用mkdir()，只会建最后一层的“旅行照片”，前面的“2024”和“08”得先存在才行，不然会报错。这时候得加个参数true，让mkdir()自动把中间缺的文件夹都建好。

比如建“用户ID为123的专属文件夹里的头像文件夹”，代码可以这么写：

`php

// 嵌套路径：当前目录下的user/123/avatar

$nested_dir = './user/123/avatar';

// 多加一个true参数，允许创建嵌套目录

if (mkdir($nested_dir, 0755, true)) {

echo "多层文件夹创建成功！";

} else {

echo "多层文件夹创建失败~";

}

`

就像你要建“家里/客厅/茶几/水杯”，不用先建“家里”再建“客厅”再建“茶几”，直接说“帮我建家里客厅茶几里的水杯”，服务员（程序）会自动按顺序建好前面的所有房间，不用你一步步说。

避坑提醒：这几种情况建不了文件夹

很多新手用mkdir()失败，大多是踩了这几个小坑，提前注意就能少走弯路：

• 路径写错了：比如把./user_upload写成了../user_upload（../代表上一级目录），服务器找不到对应位置，自然建不了。
• 权限不够：服务器的根目录一般不让随便建文件夹，比如你想在网站系统文件夹里建东西，得让服务器管理员给对应权限，不然mkdir()会返回失败。
• 文件夹已经存在：如果同一个路径的文件夹已经建好了，再用mkdir()就会报错，所以可以先加个判断，用is_dir()检查文件夹是否存在，存在就不用再建了。比如：

`php

if (!is_dir($dir)) { // 如果文件夹不存在

mkdir($dir, 0755);

}

`

学会用PHP创建目录，就能让程序自动管理文件夹，不管是用户上传的文件，还是系统自动生成的内容，都能按规矩存放，不用手动折腾。日常开发里大部分场景用这两个方法就够了，多练几次就能熟练掌握。