17370845950

PHP写文件失败需排查容器权限、路径存在性及挂载设置；常见报错定位点包括进程用户、目录属主权限、宿主机挂载配置；Docker启动时应统一UID、加SELinux标签或预设宿主机目录权限；代码中须用is_writable()和filesize()双重校验。

行，但得看容器里 PHP 进程有没有写权限、目标路径是否存在、挂载方式是否允许写入——不是“能运行 file_put_contents()”就等于“文件真能落盘”。

PHP 写文件失败的常见报错和定位点

遇到 file_put_contents(): failed to open stream: Permission denied 或 No such file or directory，别急着改代码

• 容器内 PHP 进程的运行用户（通常是 www-data 或 root），用 ps aux | grep php 或 id 确认
• 目标目录（比如 /var/www/html/uploads）在容器内的属主和权限：ls -ld /var/www/html/uploads
• 该目录是否来自宿主机挂载（-v /host/path:/container/path）？如果是，宿主机对应路径的权限和 SELinux（Linux）或 file sharing（Mac）设置也会影响容器内写入

docker run 时确保目录可写的三种做法

不改代码也能让 file_put_contents() 成功，关键在启动容器时把权限铺平：

• 用 --user 指定与目标目录属主一致的 UID，例如 --user 33:33（对应 www-data）
• 挂载时加 :z 或 :Z（仅限 SELinux 启用的 Linux 宿主机），如 -v ./uploads:/var/www/html/uploads:z
• 启动前在宿主机预设好目录权限：mkdir -p uploads && chmod 777 uploads（开发环境可接受；生产慎用）

PHP 代码里要检查的两个硬性条件

即使容器配置没问题，file_put_contents() 仍可能静默失败。务必补上这两步：

• 用 is_writable($dir) 检查目录是否真正可写，别只信 is_dir()
• 写入后用 file_exists() + filesize() 验证文件是否生成且非空，尤其当目标是挂载卷时，NFS 或某些 Docker Desktop 共享机制会导致写入延迟或截断

示例片段：

if (!is_writable('/var/www/html/uploads')) {
    error_log('Upload dir not writable');
    exit;
}
$result = file_put_contents('/var/www/html/uploads/test.txt', 'hello');
if ($result === false || filesize('/var/www/html/uploads/test.txt') === 0) {
    error_log('Write failed or file empty');
}

Docker Compose 下容易被忽略的权限陷阱

docker-compose.yml 里写 volumes: 很方便，但默认挂载行为在不同平台表现不一：

• Mac 上 Docker Desktop 的 osxfs 对 chmod 和 chown 支持有限，容器内 chown www-data:www-data /uploads 可能无效
• Windows WSL2 环境下，挂载的 Windows 路径默认不可执行 chown，需改用 WSL2 原生路径（如 /home/user/project）再挂载
• 如果用了 init: true 或自定义 entrypoint，确保它没在启动 PHP 前意外重置了目录权限

最稳的做法：把上传目录放在容器内部（非挂载），只在需要持久化时用 docker cp 或定期同步到宿主机——尤其适合 CI/CD 或临时调试场景。