Docker PHP-FPM 容器中 stdout 日志重定向问题解析

在 Docker 官方 PHP-FPM 镜像使用过程中，开发者常会遇到 PHP 应用日志无法正确输出到容器 stdout 的问题。本文将深入分析这一现象的技术原理，并提供可行的解决方案。

问题现象

当 PHP 应用配置使用 php://stdout 进行日志输出时，在 Docker 容器中这些日志会被重定向到 stderr 通道。通过检查容器内部进程文件描述符可以发现，PID 1 进程（php-fpm master 进程）的 stdout 实际上指向了 /dev/null。

技术背景

这个问题源于 PHP-FPM 的设计特性：

1. PHP-FPM 主进程会关闭标准输出文件描述符
2. 子进程继承了这个关闭状态的文件描述符
3. 当应用尝试写入 stdout 时，系统会自动将输出重定向到 stderr

这种现象在 PHP 官方 issue 中已被确认为预期行为，主要考虑到 PHP-FPM 作为后台服务通常不需要标准输出。

解决方案

方案一：使用 FD 3 重定向

可以通过在容器启动时复制 stdout 到其他文件描述符：

exec 3>&1

然后在 PHP 应用中配置日志输出到 /proc/self/fd/3

方案二：使用 init 进程

通过以下方式让容器使用 init 进程作为 PID 1：

1. 在 Dockerfile 中使用 tini 作为入口点
2. 或者运行容器时添加 --init 参数

这样 PHP-FPM 将作为子进程运行，应用可以写入 /proc/1/fd/1（即 init 进程的 stdout）

方案三：直接日志文件输出

对于容器化环境，更推荐的做法是：

1. 配置 PHP 日志输出到特定文件
2. 通过容器日志驱动收集日志
3. 或者挂载 volume 持久化日志

最佳实践建议

1. 生产环境建议使用专用日志收集方案（如 ELK）
2. 开发环境可以使用方案二快速查看日志
3. 注意容器日志大小限制，避免日志膨胀
4. 考虑使用 json 格式日志便于后续处理

理解这些底层机制有助于开发者更好地设计容器化 PHP 应用的日志系统，在满足业务需求的同时保持系统的可靠性和可维护性。