Docker中PHP应用可通过Web服务器配置+容器路径映射实现虚拟目录等效功能：一需挂载宿主机目录到容器指定路径，二需在Nginx的alias或Apache的Alias中正确配置URL与物理路径映射，三需确保PHP和Web服务容器均挂载且权限一致。
PHP 应用在 Docker 中不直接支持传统 Apache/Nginx 的“虚拟目录”（Alias/Virtual Directory）概念，但可通过 Web 服务器配置 + 容器内路径映射实现等效效果。关键在于：把宿主机的额外目录挂载进容器，并让 PHP Web 服务能通过 URL 访问该路径下的静态或动态资源。
一、理解“虚拟目录”在容器中的对应做法
虚拟目录本质是 Web 服务器将某个 URL 路径（如 /uploads）映射到文件系统中一个非 DocumentRoot 的物理路径（如 /var/www/shared/uploads）。Docker 中需两步配合：
- 使用 -v 或 volumes 将宿主机目录挂载到容器内指定路径
- 在 Nginx/Apache 配置中添加 location /xxx { alias /path/in/container; } 或 Alias 指令
二、Nginx + PHP-FPM 容器化示例（推荐）
以 Nginx 为前端、PHP-FPM 为后端的常见组合为例：
1. 目录结构
./myapp/
├── docker-compose.yml
├── nginx.conf
├── www/
│ └── index.php # 主应用入口
└── uploads/ # 宿主机上的“虚拟目录”源数据
└── avatar.jpg
2. nginx.conf 关键配置
server {
listen 80;
root /var/www/html;
index index.php;
<pre class="brush:php;toolbar:false;">location /uploads {
alias /var/www/uploads; # 注意：alias 后路径末尾无斜杠，且需与挂载目标一致
expires 1h;
}
location ~ \.php$ {
fastcgi_pass php:9000;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
}
}
3. docker-compose.yml
version: '3.8'
services:
web:
image: nginx:alpine
ports: [ "8080:80" ]
volumes:
- ./www:/var/www/html:ro
- ./uploads:/var/www/uploads:ro # ? 挂载虚拟目录源
- ./nginx.conf:/etc/nginx/conf.d/default.conf:ro
depends_on: [ php ]
<p>php:
image: php:8.2-fpm-alpine
volumes:</p>
- ./www:/var/www/html:ro
- ./uploads:/var/www/uploads:ro # ? PHP 进程也需要读取（如 file_exists、imagecreatefromjpeg）
启动后访问 http://localhost:8080/uploads/avatar.jpg 即可生效。
三、Apache + mod_php 方式（简化场景）
若用 Apache，可在 .htaccess 或虚拟主机配置中使用 Alias：
# 在 Apache 配置中（如 000-default.conf）
Alias /files "/var/www/shared/files"
<directory>
Require all granted
Options FollowSymLinks
</directory>
对应挂载方式相同：-v $(pwd)/shared-files:/var/www/shared/files:ro。
四、注意事项与避坑点
-
alias vs root：Nginx 中 alias 是完整替换路径，root 是拼接路径，别混淆（例如
location /a { alias /x/y; }→ 请求/a/1.txt对应文件/x/y/1.txt） -
权限问题：挂载目录需确保容器内运行用户（如 nginx 用户、www-data）有读取权限；Alpine 镜像常用
nginx用户，可用chown -R 101:101 uploads/预处理 - PHP 访问虚拟目录：如果 PHP 代码需要读写该目录（如上传、生成缩略图），必须同时挂载到 php 服务容器中，不能只给 Nginx
-
Windows/macOS 文件共享延迟：Docker Desktop 的文件挂载在 macOS 上可能有 inotify 延迟，开发时建议用 cached 选项（
docker-compose.yml中加:cached）
不复杂但容易忽略细节。核心就三点：挂对路径、配对指令、权限通透。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
