本文详解 docker 环境下 nginx 与 php-fpm 协同工作时 php 文件不执行、仅显示默认欢迎页的典型问题，核心原因在于 nginx 配置文件被覆盖或未生效，并提供完整修复方案与最佳实践。
在使用 docker-compose 搭建 Nginx + PHP-FPM（如 Laravel 应用）时，一个常见却极易被忽视的问题是：浏览器访问 http://localhost:8888 显示的是 Nginx 默认的 "Welcome to nginx!" 页面，而非预期的 phpinfo() 输出——这表明自定义的 PHP 路由配置根本未被加载，Nginx 实际运行的是内置的 default.conf。
? 根本原因：配置文件冲突
Nginx 官方 Alpine 镜像（nginx:stable-alpine）默认在 /etc/nginx/conf.d/ 目录下预置了 default.conf。而你的 Dockerfile 使用了：
COPY docker/nginx/conf.d/*.conf /etc/nginx/conf.d/
该命令会将 app.conf 复制到同一目录，但不会删除原有 default.conf。由于 Nginx 按字母序加载 conf.d/ 下所有 .conf 文件，且 default.conf 通常匹配 server { listen 80; } 的泛域名配置，它会优先接管所有未显式指定 server_name 的请求（包括 localhost），导致你的 app.conf 形同虚设。
✅ 验证方法：进入 Nginx 容器检查实际生效配置：
立即学习“PHP免费学习笔记（深入）”；
docker-compose exec server nginx -T | grep -A 10 "server {"你大概率会看到 default.conf 的 server 块，而非 app.conf 的内容。
✅ 正确解决方案（推荐两种）
方案一：覆盖默认配置（简洁可靠）
将 app.conf 重命名为 default.conf，并在 Dockerfile 中明确覆盖：
# docker/nginx/Dockerfile FROM nginx:stable-alpine COPY docker/nginx/conf.d/app.conf /etc/nginx/conf.d/default.conf # ← 关键：直接替换 default.conf WORKDIR /var/www/html COPY ./src/public /var/www/html/public
✅ 优势：无需修改 Nginx 启动逻辑，语义清晰，避免多配置文件竞争。
方案二：彻底清理默认配置（更规范）
在 Dockerfile 中显式删除默认配置，再复制自定义配置：
FROM nginx:stable-alpine RUN rm -f /etc/nginx/conf.d/default.conf # ← 关键：先清理 COPY docker/nginx/conf.d/app.conf /etc/nginx/conf.d/app.conf WORKDIR /var/www/html COPY ./src/public /var/www/html/public
同时建议在 app.conf 中补充 server_name 的本地测试支持：
server {
listen 80;
server_name localhost; # ← 添加此项，确保匹配 http://localhost:8888
index index.php index.html;
root /var/www/html/public;
location / {
try_files $uri /index.php?$query_string;
}
location ~ \.php$ {
fastcgi_pass php:9000; # 注意：使用服务名 'php'，非 localhost
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
include fastcgi_params;
# ↓ 推荐添加：防止路径解析错误
set $realpath_root $document_root;
}
}⚠️ 其他关键注意事项
- PHP-FPM 端口暴露无需映射宿主机：php 服务的 ports: ["9000:9000"] 是冗余且有风险的——Nginx 容器应通过 Docker 内网（php:9000）通信，而非暴露 9000 到宿主机。建议删除该行，提升安全性。
- 卷挂载路径一致性：你已正确将 ./src 挂载到 PHP 容器的 /var/www/html，并将 ./src/public 挂载到 Nginx 的 /var/www/html/public，确保 SCRIPT_FILENAME 能准确定位到 PHP 文件（$document_root 在 Nginx 中指向 /var/www/html/public，故 $document_root/index.php = /var/www/html/public/index.php，而该路径在 PHP 容器中真实存在）。
-
重启生效：修改配置后务必重建容器：
docker-compose down && docker-compose up --build -d
✅ 最终验证步骤
- 访问 http://localhost:8888 → 应显示 phpinfo() 页面；
- 查看 Nginx 错误日志定位问题：
docker-compose logs server | grep -i "error\|connect"
- 测试 PHP-FPM 连通性（从 Nginx 容器内）：
docker-compose exec server sh -c "echo -e 'GET /index.php HTTP/1.0\r\n\r\n' | nc php 9000"
遵循以上配置，即可彻底解决 Nginx 不解析 PHP 的核心障碍，为 Laravel 等 PHP 应用构建健壮、可复现的 Docker 开发环境。
