Docker Compose应分容器部署Nginx、PHP-FPM、Node.js，各司其职：Nginx反向代理，PHP-FPM监听9000，Node.js监听3000并配置healthcheck，三者共用自定义网络，确保依赖就绪与安全隔离。
直接用 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：
立即学习“PHP免费学习笔记（深入）”；
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 <node-container> 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 命令。
