如何在 Docker 容器中将 Laravel 日志输出到 stdout

laravel 默认将错误日志写入 `storage/logs/laravel.log` 文件，而非标准输出（stdout），导致 `docker logs` 无法捕获。本文提供完整解决方案：通过配置日志通道为 `stack` + `single`、设置 `log_channel=stack`，并配合 `tail -f` 实时转发日志至容器 stdout。

在容器化 Laravel 应用（尤其是运行于 Docker 或 Kubernetes 环境）时，遵循“12-Factor App”原则要求应用将日志直接输出到 stdout/stderr，由容器运行时统一收集（如 docker logs、Fluentd、Elasticsearch 等）。但 Laravel 默认使用 single 或 daily 文件驱动，日志仅落盘，不触达容器标准流——这正是你执行 php artisan command5 报错却在 docker logs -f travellist-app 中看不到任何 Laravel 错误信息的根本原因。

✅ 正确配置步骤

1. 确保 config/logging.php 使用可输出到 stdout 的通道组合

推荐采用 stack 驱动聚合多个通道，并将 single 作为唯一子通道（注意：此处的 single 本身仍写文件，后续需靠 tail 转发；若追求纯 PHP 层直出 stdout，可改用 errorlog 驱动，见下方进阶说明）：

// config/logging.php
'channels' => [
    'stack' => [
        'driver' => 'stack',
        'channels' => ['single'], // ← 关键：只包含 single（或其他持久化通道）
        'ignore_exceptions' => false,
    ],

    'single' => [
        'driver' => 'single',
        'path' => storage_path('logs/laravel.log'),
        'level' => 'debug',
        'permission' => 0660,
    ],
],

⚠️ 注意：single 驱动本身不会自动写入 stdout，它只是确保所有日志（包括 Artisan 命令异常）都集中写入 laravel.log —— 这是后续 tail 转发的前提。

2. 设置环境变量启用 stack 通道

在 .env 文件中明确指定：

LOG_CHANNEL=stack

此配置强制 Laravel 所有日志（HTTP 请求、队列、Artisan 命令等）均经由 stack 通道处理，最终落地到 storage/logs/laravel.log。

3. 在容器启动后实时 tail 日志文件到 stdout

这是最关键的一步：让容器主进程（PID 1）的标准错误流持续接收日志内容。在 Dockerfile 的 ENTRYPOINT 或 Kubernetes 的 lifecycle.postStart 中执行：

# 推荐写法（兼容性高，避免文件不存在报错）
touch /var/www/storage/logs/laravel.log && \
tail -f /var/www/storage/logs/laravel.log > /proc/1/fd/2 &

• /proc/1/fd/2 指向容器主进程（通常是 PHP-FPM master 或自定义入口脚本）的 stderr；
• & 确保 tail 后台运行，不阻塞主进程启动；
• touch 预创建日志文件，防止首次 tail 失败。

✅ Docker Compose 示例（docker-compose.yml）：

services:
  app:
    build: .
    # ... 其他配置
    entrypoint: >
      sh -c "
        touch /var/www/storage/logs/laravel.log &&
        tail -f /var/www/storage/logs/laravel.log > /proc/1/fd/2 &
        exec docker-php-entrypoint php-fpm
      "

✅ Kubernetes Deployment 片段（如原答案所示）：

WPS AI

金山办公发布的AI办公应用，提供智能文档写作、阅读理解和问答、智能人机交互的能力。

下载

lifecycle:
  postStart:
    exec:
      command:
        - /bin/bash
        - -c
        - |
          touch /var/www/storage/logs/laravel.log &&
          tail -f /var/www/storage/logs/laravel.log > /proc/1/fd/2 &

? 替代方案：PHP 层直出 stdout（无需 tail）

若希望完全绕过文件 I/O，可将 single 替换为 errorlog 驱动（Laravel 8+ 原生支持）：

'stdout' => [
    'driver' => 'errorlog',
    'level' => 'debug',
    'layout' => 'line', // 可选：格式化为单行便于日志采集
],

再设 LOG_CHANNEL=stdout。此方式由 PHP 的 error_log() 函数直接写入 stderr，零依赖外部命令，更符合云原生最佳实践，但需确认你的 PHP 容器已正确配置 error_log = /proc/1/fd/2（通常默认即如此）。

✅ 验证效果

重启容器后执行触发错误的 Artisan 命令：

docker exec -it travellist-app php artisan command5

立即在另一终端运行：

docker logs -f travellist-app

你将看到类似以下实时输出（含堆栈）：

[2024-06-15 08:22:33] local.ERROR: Command "command5" is not defined. {"exception":"[object] (Symfony\\Component\\Console\\Exception\\CommandNotFoundException(code: 0): Command \"command5\" is not defined. at /var/www/vendor/symfony/console/Application.php:644)..."}

? 总结

选择任一方案，即可让 Laravel 错误、警告、调试日志完整出现在 docker logs 流中，无缝接入现代可观测性体系。