如何在Docker中构建包含PHP 8.3与Node.js的混合环境_实现全栈开发镜像搭建-php教程-PHP中文网

docker compose应分容器部署nginx、php-fpm、node.js，各司其职：nginx反向代理，php-fpm监听9000，node.js监听3000并配置healthcheck，三者共用自定义网络，确保依赖就绪与安全隔离。

如何在docker中构建包含php 8.3与node.js的混合环境_实现全栈开发镜像搭建

直接用 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 或数据库连接时），否则健康检查会提前失败并重试多次。

Docker Compose Linter

检查 docker-compose.yml 文件的安全问题、最佳实践和端口冲突

下载

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 <node-container> ps aux | grep node</node-container>，看 USER 列是否为 node
若 Node.js 需监听 80 端口（不推荐），改用 setcap 'cap_net_bind_service=+ep' /usr/local/bin/node，而非切回 root