PHP在服务器创建文件夹，最直接的做法是调用mkdir()函数，路径写绝对路径，权限用0755，需要多级目录时把第三个参数设为true，并确保PHP运行用户对父目录有写权限。 如果你只记一句话，就记：函数本身不难,难在路径和权限。
据W3Techs公开统计，PHP在服务端脚本语言中仍有较大使用比例，大量站点运行在Linux加PHP-FPM的环境里，也正因为环境常见，创建文件夹失败往往不是“不会写代码”，而是执行用户、open_basedir、面板权限这些细节没对上。
先看mkdir()：三个参数决定成败
路径参数：相对路径容易埋雷
相对路径基于PHP当前工作目录，不是脚本文件所在目录，在命令行跑脚本和在FPM里跑脚本，当前目录可能完全不同，实操里更稳的写法是用__DIR__拼绝对路径。
$dir = __DIR__ . '/uploads/2026';
if (!is_dir($dir)) {
if (!mkdir($dir, 0755, true)) {
$err = error_get_last();
error_log('mkdir failed: ' . $dir . ' ' . ($err['message'] ?? ''));
}
}
先is_dir()再mkdir()可以避免重复创建时产生警告。error_get_last()用于记录真实原因，比只返回一个false更有排查价值。
权限参数：0755不是万能，0777要慎用
目录权限里的执行位很关键，没有执行位，进程进不去目录，读文件也会失败。0755表示所有者可读写执行，组和其他用户可读可执行,这是Web目录的常用起点。
上传目录如果要求同组进程写入，可以给0775。0777尽量别用，尤其上传目录，开放过大容易放大脚本上传风险，业内专家指出，上传目录的可写权限应尽量收窄,并与脚本执行权限隔离。
mkdir()传入的mode还会受到umask影响，命令行用umask查看，PHP里可用umask()读取或临时设置，线上不建议为了省事全局改umask，更稳的是创建后用chmod()校准最终权限。
递归参数：true解决多级目录
mkdir('/www/wwwroot/site/uploads/2026/03', 0755, true);
第三个参数为true时，父目录不存在会逐级创建，PHP没有Java那种mkdirs()方法，PHP的mkdir($path, 0755, true)就是递归创建多级目录的写法，注意中间目录的最终权限仍受umask影响,特殊场景可创建后逐级检查。
php mkdir递归创建多级目录，权限失败怎么解决？
递归创建失败，多数情况不是递归参数没写,而是进程压根没有写父目录的资格。
Permission denied的四个常见来源
- 父目录对PHP-FPM用户不可写，先看运行用户，常见是
www-data、www或nginx，命令：ls -ld /www/wwwroot/site。 open_basedir限制，目标路径不在允许列表里，mkdir()会失败，用phpinfo()或ini_get('open_basedir')确认。- SELinux或AppArmor拦截，SELinux用
getenforce查看，Enforcing状态下需要正确的文件上下文,不要直接关掉了事。 - 磁盘满、inode满或挂载只读，用
df -h、df -i、mount检查。
用is_writable()和fileperms()定位
$parent = dirname($dir);
if (!is_writable($parent)) {
error_log('parent not writable: ' . $parent);
}
fileperms()返回整数权限，用decoct(fileperms($parent) & 0777)转成八进制看得更直观，排查时把“PHP运行用户是谁”“父目录属主是谁”“父目录权限是多少”三件事对齐,问题通常就露出来了。
创建后无法写入：属主和属组要匹配
命令行用root创建目录，PHP-FPM用www运行，属主不一致就会“目录建出来了，但程序写不进去”,修正命令示例：
chown -R www:www /www/wwwroot/site/uploads chmod -R 0755 /www/wwwroot/site/uploads
需要组内多进程协作时，可用2775让新文件继承属组，但不要无条件放开。属主和属组匹配，比单纯调大权限更有效。
linux服务器php创建文件夹命令，和宝塔面板设置有什么不同？
命令行mkdir与PHP mkdir()的差异
| 对比项 | 命令行mkdir |
PHP mkdir() |
|---|---|---|
| 执行用户 | 当前登录用户 | PHP-FPM用户，如www |
| 递归创建 | mkdir -p |
第三参数true |
| 权限来源 | -m加umask |
mode加umask |
| 错误提示 | 终端stderr | 警告、返回值、错误日志 |
| 路径基准 | Shell当前目录 | PHP当前工作目录 |
命令行能建，PHP不能建，优先怀疑执行用户不同，命令行用sudo -u www mkdir -p /path试一次,很快能验证。
宝塔面板php创建文件夹权限设置
宝塔里网站目录通常在/www/wwwroot/域名，PHP-FPM用户多为www,实操路径：
- 打开宝塔面板，进入网站设置,查看网站目录和运行用户。
- 文件管理里看目标目录属主是否为
www:www，权限是否为755。 - 网站设置里检查“防跨站攻击”的
open_basedir，目标目录必须在允许范围内,或者按业务需要调整。 - 上传目录单独设置，不要给整个站点目录
777。
宝塔面板php创建文件夹权限设置的关键，是让面板里的属主、权限和PHP实际运行用户一致，而不是只看文件管理器显示“可写”。
香港服务器、虚拟主机和价格差异的场景
香港服务器php创建文件夹权限和内地服务器没有本质区别，Linux权限模型一样，差别多在默认用户、挂载路径和面板策略，云服务器价格从几十元到几百元不等，价格差异不会改变mkdir()的权限逻辑；虚拟主机价格低，但常把可写目录限制在面板指定范围，行业共识认为，共享虚拟主机更依赖服务商授权,独立服务器和云服务器则要给对属主与权限。
安全与健壮性：别只盯着“能建出来”
防止路径穿越
用户输入不要直接拼进mkdir()，用basename()取文件名，用白名单限定目录，拼接后用realpath()校验目标仍在允许根目录内。
$base = '/www/wwwroot/site/uploads';
$name = basename($_POST['dir'] ?? '');
$dir = $base . '/' . $name;
$realBase = realpath($base);
$realDir = realpath(dirname($dir));
if ($realDir === false || strpos($realDir, $realBase) !== 0) {
exit('invalid path');
}
并发创建与错误处理
多进程同时创建同一目录，先is_dir()再mkdir()仍有窗口。mkdir()失败后立刻再is_dir()确认，能区分“别人先建了”和“真的失败”，不要用@mkdir()把错误吞掉,记录日志才有排查线索。
把结论落在一处
PHP在服务器创建文件夹，核心就是绝对路径、合理权限、递归参数、运行用户可写四件事对齐，权限问题优先查父目录和PHP-FPM用户，不要一开始就改777。
php怎么在服务器创建文件夹：高频问答
mkdir()返回true但目录不存在，怎么回事？
先确认路径是否被open_basedir限制，再检查是否写到了相对路径对应的其他目录，用realpath()和is_dir()复核,日志里记录完整绝对路径。
php mkdir和mkdirs区别是什么？
PHP没有内置mkdirs()函数，递归创建用mkdir($path, 0755, true)。mkdirs()常见于Java等语言,别把其他语言的写法套到PHP里。
虚拟主机里PHP创建文件夹没权限怎么办？
先在面板确认可写目录，再用FTP或文件管理创建目标目录并设置权限，共享虚拟主机中，PHP进程通常只能写入面板指定的可写目录,这是产品权限设计决定的。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/article/782504.html
