DockerNginx无法解析PHP解决方案

本篇文章给大家分享《Docker Nginx 无法解析 PHP 解决方法》，覆盖了文章的常见基础知识，其实一个语言的全部知识点一篇文章是不可能说完的，但希望通过这些问题，让读者对自己的掌握程度有一定的认识(B 数)，从而弥补自己的不足，更好的掌握它。

本文详解 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 容器检查实际生效配置：

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

✅ 最终验证步骤

1. 访问 http://localhost:8888 → 应显示 phpinfo() 页面；
2. 查看 Nginx 错误日志定位问题：

   docker-compose logs server | grep -i "error\|connect"

3. 测试 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 开发环境。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~