如何解决 Docker 中 Nginx 无法解析 PHP 文件的问题-php教程-PHP中文网

如何解决 Docker 中 Nginx 无法解析 PHP 文件的问题

本文详解 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 的内容。

htmlppt.skill

把任意文章或文档内容转换成精美的全屏翻页 HTML 演示文件（幻灯片风格）。当用户发来一篇文章、文档链接、Markdown 内容、或粘贴的文本，并且希望生成演示用的 HTML 时触发。支持任意内容来源：iWiki 链接、KM 链接、本地文件路径、直接粘贴的文本。生成的 HTML 文件保存到本地工作区，并通过企微直接发送给用户。触发词示例：帮我把这篇文章做成PPT、转成演示文档、生成HTML幻灯片、做个演示、转成可以演示的格式、article to deck、make a slide。

下载

✅ 正确解决方案（推荐两种）

方案一：覆盖默认配置（简洁可靠）

将 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 开发环境。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！