Docker搭建PHP8.3与Node.js环境教程

本文详解如何使用 Docker Compose 正确构建 PHP 8.3 与 Node.js 的混合开发环境，强调必须遵循“一个容器一个进程”原则，通过分离部署 Nginx（反向代理）、PHP-FPM（监听9000）和 Node.js（监听3000并配置健康检查）三个服务，实现职责清晰、安全隔离、独立伸缩；同时纠正常见误区——如拒绝单容器硬塞双运行时、明确 PHP 应选用轻量高效的 `php:8.3-fpm` 而非 Apache 镜像、强制 Node.js 以非 root 用户运行、合理设置 `depends_on` 与 `healthcheck` 确保启动顺序可靠，并指出 PHP 调用 Node 功能应走 HTTP API 而非本地 shell 执行，真正落地生产级可维护、易排查、高安全的现代化 Web 架构。

直接用 docker-compose 起三个服务，别硬塞进一个容器

PHP 和 Node.js 本质是不同运行时，强行合并在单个容器里会导致启动顺序难控、日志混杂、健康检查失效、进程管理混乱。官方最佳实践和生产环境都推荐分容器部署：Nginx（反向代理）+ PHP-FPM + Node.js。这样每个服务可独立伸缩、重启、升级，也符合 Docker 的“一个容器一个进程”原则。

常见错误现象：php-fpm 启动后 Node.js 还没 ready，前端请求 /api/ 就 502；或者 docker logs 里 PHP 错误和 Node.js 堆栈挤在一行，排查困难。

• Node.js 容器只暴露内部端口（如 3000），不映射到宿主机
• PHP-FPM 容器监听 9000，不暴露 HTTP 端口
• Nginx 容器挂载自定义配置，用 fastcgi_pass php:9000 和 proxy_pass http://node:3000
• 所有容器共用同一自定义网络（如 app-network），避免用 bridge 默认网段导致 DNS 解析失败

docker-compose.yml 中必须显式声明依赖与就绪检查

PHP 应用常需调用 Node.js 接口（比如调用 node process-image.js），但 depends_on 默认只检查容器是否“启动”，不保证 Node.js 服务已监听端口或完成初始化。若跳过健康检查，PHP 可能因连接拒绝而报 Connection refused。

正确做法是在 node 服务块中加 healthcheck：

node:
  image: node:24-alpine
  working_dir: /app
  volumes:
    - ./node-app:/app
  healthcheck:
    test: ["CMD", "curl", "-f", "http://localhost:3000/health"]
    interval: 30s
    timeout: 10s
    retries: 3
    start_period: 40s

同时在 php 服务中用 depends_on 引用该检查：

php:
  depends_on:
    node:
      condition: service_healthy

注意：start_period 要大于 Node.js 应用冷启动时间（尤其含大量 require 或数据库连接时），否则健康检查会提前失败并重试多次。

PHP 8.3 镜像选 php:8.3-apache 还是 php:8.3-fpm？

选 php:8.3-fpm。混合架构下 Nginx 已作为统一入口，PHP 不再需要内置 Apache；用 FPM 模式更轻量、资源占用更低、与 Nginx 配合更标准。Apache 模式反而会多一层 mod_proxy_fcgi 转发，增加延迟和配置复杂度。

关键差异点：

• php:8.3-apache 自带 apache2 进程，监听 80，需额外禁用或覆盖配置
• php:8.3-fpm 默认只启 php-fpm，监听 9000，开箱即用于 FastCGI 场景
• 扩展安装方式一致（docker-php-ext-install），但 apcu、opcache 等性能扩展在 FPM 下生效更直接
• 日志路径不同：FPM 的 error_log 默认输出到 stderr，方便 docker logs 直接捕获

Node.js 容器内务必用非 root 用户运行

默认 node 镜像以 root 启动进程，一旦被利用（如通过恶意 npm 包或未过滤的 child_process.exec），可能获得容器内最高权限。PHP-FPM 容器通常也做了用户隔离（如用 www-data），Node.js 不同步就会破坏整体安全基线。

实操建议：

• 在 Node.js 项目根目录加 useradd -r -u 1001 -g www-data nodejs 不现实 —— 改用镜像内置用户：node:24-alpine 已预建 node 用户（UID 1001）
• Dockerfile 中加：USER node，且确保 /app 目录对 node 用户可读写（RUN chown -R node:node /app）
• 验证方式：docker exec -it ps aux | grep node，看 USER 列是否为 node
• 若 Node.js 需监听 80 端口（不推荐），改用 setcap 'cap_net_bind_service=+ep' /usr/local/bin/node，而非切回 root

容易被忽略的一点：PHP 调用 shell_exec('node script.js') 时，如果宿主机没装 Node.js，该命令必然失败 —— 此时应让 PHP 调用的是容器内的 Node.js 服务（HTTP API），而不是试图在 PHP 容器里执行 node 命令。

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