Docker PHP 7.2-fpm-alpine 容器日志输出问题解析

在使用 Docker 部署 PHP 应用时，日志管理是一个需要特别注意的环节。本文将以 PHP 7.2-fpm-alpine 镜像为例，深入探讨 PHP 错误日志的输出机制，以及如何正确配置使其能够输出到标准输出(stdout)和标准错误(stderr)。

问题现象

许多开发者在初次使用 PHP-FPM 容器时，会遇到一个常见问题：当应用出现 500 错误时，在容器日志中看不到任何错误信息。这给调试带来了很大困难，因为无法确定错误的具体原因。

原因分析

PHP-FPM 默认的日志配置与传统的 PHP 运行模式有所不同。在容器环境中，PHP-FPM 的错误日志默认不会自动输出到标准输出/错误流，而是写入到文件或系统日志中。

在 PHP-FPM 的配置文件中，有三个关键参数控制着错误日志的行为：

1. error_log：指定错误日志的输出位置
2. log_level：设置日志记录的级别
3. catch_workers_output：控制是否捕获工作进程的输出

解决方案

要使 PHP-FPM 的错误日志输出到容器的标准输出/错误流，需要进行以下配置：

1. 修改 PHP-FPM 配置文件：在 /usr/local/etc/php-fpm.d/docker.conf 中，确保有以下配置：

[global]
error_log = /proc/self/fd/2

[www]
access.log = /proc/self/fd/2
catch_workers_output = yes

2. 设置适当的日志级别：在 php.ini 中配置：

error_reporting = E_ALL
display_errors = Off
display_startup_errors = Off
log_errors = On
log_errors_max_len = 1024
ignore_repeated_errors = Off
ignore_repeated_source = Off
report_memleaks = On

3. 确保错误日志指向标准错误流：通过将错误日志重定向到 /proc/self/fd/2，可以让日志输出到容器的标准错误流。

最佳实践

1. 开发环境配置：在开发环境中，可以启用 display_errors 以便直接在浏览器中查看错误信息。

2. 生产环境配置：在生产环境中，应该关闭 display_errors，但确保 log_errors 开启，并将错误日志输出到标准错误流，方便通过 Docker 的日志收集系统进行收集和分析。

3. 日志级别选择：根据实际需要选择合适的日志级别，通常 E_ALL 适用于开发环境，而生产环境可能需要更严格的级别。

4. 日志轮转：对于长期运行的容器，考虑使用日志轮转策略，避免日志文件过大。

总结

正确配置 PHP-FPM 的日志输出对于容器化 PHP 应用的运维至关重要。通过将错误日志重定向到标准错误流，可以更好地与 Docker 的日志系统集成，方便日志的收集、分析和监控。理解这些配置项的含义并根据实际环境进行适当调整，将大大提高 PHP 应用在容器环境中的可观测性和可维护性。