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

在 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 代码即可正常运行

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

夏夕资源网专注于CMS网站模板,主流语言整站网站源码下载,网站建设相关教程分享,好用的软件素材整合下载,提供一站式便捷自助服务。
1. 本站所有资源来源于用户上传和网络,如有侵权请邮件联系站长!
2. 分享目的仅供大家学习和交流,您必须在下载后24小时内删除!
3. 不得使用于非法商业用途,不得违反国家法律。否则后果自负!
4. 本站提供的源码、模板、插件等等其他资源,都不包含技术服务请大家谅解!
5. 如有链接无法下载、失效或广告,请联系管理员处理!
6. 本站资源售价只是赞助,收取费用仅维持本站的日常运营所需!
7. 如遇到加密压缩包,默认解压密码为"zy.lucklyus.top",如遇到无法解压的请联系管理员!
夏夕资源网-网站模板_免费源码_资源素材 » PHP Docker 中 mkdir() 权限被拒绝的完整解决方案-php教程
在线时间:12:00 - 22:00
关注微信公众号:微信公众号
站长邮箱:[email protected]
  • 运营天数: 1392+
  • 资源总数: 47989+
  • 用户总数: 1+
  • 今日更新: 0+
  • 访问次数: 4001805+
  • 本周更新: 0+
  • 最后更新: 2026-03-16

本站指数

×
  • 运营天数: 1392+
  • 资源总数: 47989+
  • 用户总数: 1+
  • 今日更新: 0+
  • 访问次数: 4001805+
  • 本周更新: 0+
  • 最后更新: 2026-03-16