documentroot 配合容器卷挂载的核心是确保 apache 容器内 documentroot 路径与宿主机挂载路径严格一致，挂载解决文件可见性，documentroot 指令决定 web 入口；必须显式配置 documentroot 为挂载目标路径（如 "/var/www/myapp/public"），而非依赖镜像默认值，同时注意权限、路径语义及斜杠一致性。
DocumentRoot 配合容器卷挂载，核心是让 Apache 容器内看到的 DocumentRoot 路径，真实指向宿主机上你准备好的网站代码目录。它不是“自动生效”，而是靠挂载路径与配置指令对齐来实现——挂载解决文件可见性，DocumentRoot 指令决定哪个目录被当作 Web 入口。
DocumentRoot 必须和挂载目标路径一致
Apache 容器启动时，默认 DocumentRoot 通常是 /usr/local/apache2/htdocs（官方镜像）或 /app（部分定制镜像）。如果你用 volume 挂载把宿主机的 ./myweb 映射到容器内 /var/www/html，但 DocumentRoot 还是默认的 /usr/local/apache2/htdocs，那浏览器访问的仍是空目录，你的代码根本不会被加载。
所以必须做两件事之一：
- 改 Apache 配置，把 DocumentRoot 设为挂载目标路径，例如
DocumentRoot "/var/www/html"； - 或者保持默认 DocumentRoot，但把代码挂载到它的默认位置，例如
volumes: - ./myweb:/usr/local/apache2/htdocs。
推荐第一种：显式声明 DocumentRoot，避免依赖镜像默认值，更可控、可迁移。
Apache 2.4.62
下载
PHP中文网提供Apache 2.4.62 官方 tar.gz 源码包下载，通过源码编译安装，开发者能够灵活定制模块、优化性能并精准控制安装路径，满足多样化的业务需求。
挂载方式要匹配权限与路径语义
挂载不是简单复制文件，它把宿主机路径“透传”进容器。因此要注意：
- 挂载点必须是绝对路径，且容器内用户（如 www-data 或 daemon）要有读取权限；
- 如果挂载的是整个项目目录（含
public/子目录），DocumentRoot 就得设为/var/www/myapp/public，不能设成项目根目录，否则暴露 config、.env 等敏感文件； - Linux 宿主机挂载后，若 Apache 报 403，大概率是 SELinux 或文件权限问题；Windows/macOS 用户需确认共享设置已启用，并检查文件执行位（PHP 需要可读+可执行）。
配置示例：Docker Compose + 自定义 DocumentRoot
假设你有项目结构：./myapp/public/index.php，希望它成为 Web 入口：
- 在宿主机创建配置文件
httpd.conf，覆盖默认配置，关键段落如下：
DocumentRoot "/var/www/myapp/public"
Require all granted
AllowOverride All
- Docker Compose 中挂载代码 + 配置：
- ./myapp:/var/www/myapp
- ./httpd.conf:/usr/local/apache2/conf/httpd.conf
这样，容器内 DocumentRoot 指向挂载后的 /var/www/myapp/public，PHP 文件就能被正确解析（前提是 PHP 模块已启用、AddType 已配置）。
常见踩坑点
-
挂载覆盖了整个 conf 目录：比如
- ./conf:/usr/local/apache2/conf，会把原镜像里的extra/、original/等子目录一并替换，导致模块加载失败。应只挂载必要文件（如httpd.conf）或用 volume + COPY 分层管理； -
路径末尾斜杠不一致：DocumentRoot 写成
"/var/www/myapp/public/"（带斜杠），某些 Apache 版本可能报 403；统一用无尾斜杠写法更稳妥； - 挂载后文件时间戳异常或缓存未更新：尤其在 Docker Desktop for Mac/Windows 上，启用“Use the gRPC FUSE file sharing”或调整 inotify 限制可缓解。
