0

0

PHP Docker 中 mkdir() 权限被拒绝的完整解决方案

聖光之護

聖光之護

发布时间:2026-02-07 19:49:52

|

788人浏览过

|

来源于php中文网

原创

PHP Docker 中 mkdir() 权限被拒绝的完整解决方案

docker 容器中运行 php 时,`mkdir()` 报错 “permission denied”,根本原因是 apache(以 `www-data` 用户身份运行)无权在 `/var/www/html/` 下创建目录;需通过 `chown` 正确设置目录所有权。

当你在基于 php:7.3-apache 的 Docker 容器中执行 mkdir(),却遇到如下错误:

Warning: mkdir(): Permission denied in /var/www/html/test.php on line 9

这并非 PHP 配置或代码逻辑问题,而是典型的 Linux 文件权限与用户上下文不匹配问题:Apache 子进程默认以 www-data 用户身份运行,而你通过 COPY . /var/www/html/ 复制进容器的文件/目录,其属主仍是构建时的 root(或宿主机用户),导致 www-data 无法写入。

✅ 正确解决方案:在 Dockerfile 中显式授权

只需在 COPY 指令后、EXPOSE 前添加一行 chown,将 /var/www 及其子目录所有权递归赋予 www-data:www-data:

FROM php:7.3-apache

RUN apt-get update && apt-get install -y git
RUN docker-php-ext-install pdo pdo_mysql mysqli
RUN a2enmod rewrite

COPY . /var/www/html/
RUN chown -R www-data:www-data /var/www  # ← 关键修复行

EXPOSE 80/tcp
EXPOSE 443/tcp
? 注意:chown -R www-data:www-data /var/www 必须放在 COPY 之后、容器启动之前(即构建阶段),确保运行时 www-data 对整个 Web 根目录拥有读写权限。

? 补充说明与最佳实践

  • 不要依赖 0777 权限掩码:即使 mkdir($path, 0777, true) 显式设为全权限,若父目录对 www-data 不可写(如属主为 root),创建仍会失败。权限掩码仅控制新目录的 初始 权限,不解决属主问题。
  • 避免在运行时 chmod 777:临时修改权限存在安全风险,且容器重启后失效;应在镜像构建阶段固化权限模型。
  • 验证是否生效:可在容器内执行 docker exec -it php6 ls -ld /var/www /var/www/html,确认输出类似:
    drwxr-xr-x 1 www-data www-data 4096 ... /var/www
    drwxr-xr-x 1 www-data www-data 4096 ... /var/www/html
  • 额外加固建议(可选):若项目无需写入整个 /var/www,可更精确授权,例如:
    RUN chown -R www-data:www-data /var/www/html/login /var/www/html/movie

✅ 修复后你的 PHP 代码即可正常运行

无需修改原有逻辑,以下代码将顺利创建嵌套目录:

ModelArts
ModelArts

华为AI开发平台ModelArts,面向开发者的一站式AI开发平台

下载

立即学习PHP免费学习笔记(深入)”;

⚠️ 小提示:你原代码中 $dirPathpr = $root . $postk . " / " . $room_id; 的 " / " 含空格,会导致路径非法(如 login/1220 / foile),请务必删除空格,改为 " / " → "/"。

至此,mkdir() 权限问题彻底解决——核心在于让运行 PHP 的 www-data 用户真正拥有目标目录的归属权,而非仅靠 chmod 或代码参数“硬扛”。这是 Docker 化 PHP 应用的标准化权限治理实践。

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
k8s和docker区别
k8s和docker区别

k8s和docker区别有抽象层次不同、管理范围不同、功能不同、应用程序生命周期管理不同、缩放能力不同、高可用性等等区别。本专题为大家提供k8s和docker区别相关的各种文章、以及下载和课程。

264

2023.07.24

docker进入容器的方法有哪些
docker进入容器的方法有哪些

docker进入容器的方法:1. Docker exec;2. Docker attach;3. Docker run --interactive --tty;4. Docker ps -a;5. 使用 Docker Compose。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

504

2024.04.08

docker容器无法访问外部网络怎么办
docker容器无法访问外部网络怎么办

docker 容器无法访问外部网络的原因和解决方法:配置 nat 端口映射以将容器端口映射到主机端口。根据主机兼容性选择正确的网络驱动(如 host 或 overlay)。允许容器端口通过主机的防火墙。配置容器的正确 dns 服务器。选择正确的容器网络模式。排除主机网络问题,如防火墙或连接问题。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

406

2024.04.08

docker镜像有什么用
docker镜像有什么用

docker 镜像是预构建的软件组件,用途广泛,包括:应用程序部署:简化部署,提高移植性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

445

2024.04.08

apache是什么意思
apache是什么意思

Apache是Apache HTTP Server的简称,是一个开源的Web服务器软件。是目前全球使用最广泛的Web服务器软件之一,由Apache软件基金会开发和维护,Apache具有稳定、安全和高性能的特点,得益于其成熟的开发和广泛的应用实践,被广泛用于托管网站、搭建Web应用程序、构建Web服务和代理等场景。本专题为大家提供了Apache相关的各种文章、以及下载和课程,希望对各位有所帮助。

412

2023.08.23

apache启动失败
apache启动失败

Apache启动失败可能有多种原因。需要检查日志文件、检查配置文件等等。想了解更多apache启动的相关内容,可以阅读本专题下面的文章。

932

2024.01.16

Java 流式处理与 Apache Kafka 实战
Java 流式处理与 Apache Kafka 实战

本专题专注讲解 Java 在流式数据处理与消息队列系统中的应用,系统讲解 Apache Kafka 的基础概念、生产者与消费者模型、Kafka Streams 与 KSQL 流式处理框架、实时数据分析与监控,结合实际业务场景,帮助开发者构建 高吞吐量、低延迟的实时数据流管道,实现高效的数据流转与处理。

42

2026.02.04

磁盘配额是什么
磁盘配额是什么

磁盘配额是计算机中指定磁盘的储存限制,就是管理员可以为用户所能使用的磁盘空间进行配额限制,每一用户只能使用最大配额范围内的磁盘空间。php中文网为大家提供各种磁盘配额相关的内容,教程,供大家免费下载安装。

1478

2023.06.21

Golang处理数据库错误教程合集
Golang处理数据库错误教程合集

本专题整合了Golang数据库错误处理方法、技巧、管理策略相关内容,阅读专题下面的文章了解更多详细内容。

39

2026.02.06

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
MySQL 教程
MySQL 教程

共48课时 | 2.1万人学习

MySQL 初学入门(mosh老师)
MySQL 初学入门(mosh老师)

共3课时 | 0.3万人学习

简单聊聊mysql8与网络通信
简单聊聊mysql8与网络通信

共1课时 | 823人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号