Docker容器中PHP无法移动文件：权限问题求助

问题根源 #

你Dockerfile里的chown和chmod命令之所以没生效，是因为容器启动时通过volumes: - .:/var/www/html把宿主机当前目录挂载到了容器的/var/www/html下，这会完全覆盖镜像构建时创建的/var/www/html目录及其中的权限设置。挂载后的文件权限继承自宿主机，在容器内显示为root所有，导致PHP（以www-data用户运行）无法写入。

解决方案 #

方案1：调整宿主机目录权限（最简单直接） #

容器内www-data用户的UID通常是33（可进入容器执行id www-data确认），在宿主机的项目根目录执行以下命令，将目录权限改为对应UID：

sudo chown -R 33:33 .

这样挂载到容器后，文件所有者会自动对应容器内的www-data:www-data，无需每次重启容器手动修改。

方案2：容器启动时自动修正权限（适合无法修改宿主机权限的场景） #

如果无法修改宿主机目录权限，可以通过启动脚本在容器启动时自动调整上传目录的权限：

1. 在项目根目录创建entrypoint.sh脚本：

#!/bin/bash
# 仅修改需要写入的上传目录权限，避免遍历整个项目目录
chown -R www-data:www-data /var/www/html/src/reports/upload/files
# 执行容器原本的启动命令
exec "$@"

2. 修改.docker/php/Dockerfile，添加以下内容到末尾：

# 复制启动脚本并赋予执行权限
COPY entrypoint.sh /usr/local/bin/
RUN chmod +x /usr/local/bin/entrypoint.sh
# 设置入口脚本
ENTRYPOINT ["entrypoint.sh"]
# 保留Apache默认启动命令
CMD ["apache2-foreground"]

3. 重新构建镜像并启动容器：

docker compose down
docker compose build
docker compose up -d

这样每次容器启动时都会自动修正上传目录的权限，无需手动操作。

方案3：修改Apache运行用户（不推荐，存在安全风险） #

仅适合测试环境，生产环境绝对禁止使用：
在.docker/php/Dockerfile中添加：

# 修改Apache运行用户为root
RUN sed -i 's/APACHE_RUN_USER www-data/APACHE_RUN_USER root/' /etc/apache2/envvars
RUN sed -i 's/APACHE_RUN_GROUP www-data/APACHE_RUN_GROUP root/' /etc/apache2/envvars

此方案会带来严重安全隐患，不建议用于正式环境。

验证 #

容器启动后，进入容器执行ls -al /var/www/html/src/reports/upload/files，确认所有者为www-data:www-data，此时PHP的move_uploaded_file即可正常工作。

内容的提问来源于stack exchange，提问作者Z3R0