LaravelDocker输出日志到stdout方法

一分耕耘，一分收获！既然都打开这篇《Laravel Docker 日志输出到 stdout 方法》，就坚持看下去，学下去吧！本文主要会给大家讲到等等知识点，如果大家对本文有好的建议或者看到有不足之处，非常欢迎大家积极提出！在后续文章我会继续更新文章相关的内容，希望对大家都有所帮助！

本文详解如何配置 Laravel 使其错误和调试日志实时输出到容器标准输出（stdout），解决 `docker logs` 无法捕获 Laravel 日志的问题，适用于 Docker、Kubernetes 等容器化部署场景。

默认情况下，Laravel 将日志写入 storage/logs/laravel.log 文件，而不会自动转发到 stdout 或 stderr —— 这导致 docker logs -f 命令无法看到应用层错误（如 Artisan 命令未定义、异常堆栈等），仅显示 PHP-FPM 启动日志。要实现可观测性统一（尤其在 Kubernetes 中依赖 stdout/stderr 收集日志），需进行三步关键配置：

✅ 步骤 1：配置 Laravel 日志通道为 stack + single（并确保不忽略异常）

修改 config/logging.php，确保 stack 通道明确包含 single，且 ignore_exceptions => false（否则命令行异常可能被静默丢弃）：

'channels' => [
    'stack' => [
        'driver' => 'stack',
        'channels' => ['single'], // 必须显式包含 single
        'ignore_exceptions' => false, // 关键！避免 Artisan 异常被跳过
    ],

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

? 提示：Laravel 7+ 默认已启用 stack 通道，但若项目自定义过 logging.php，请确认上述配置存在且生效。

✅ 步骤 2：强制 Laravel 使用 stack 通道

在 .env 文件中设置：

LOG_CHANNEL=stack

运行 php artisan config:clear（或重建容器以确保环境变量生效）。该配置使所有日志（包括 Artisan 命令错误、HTTP 请求异常、队列失败等）均通过 stack 通道写入 laravel.log。

✅ 步骤 3：将日志文件实时 tail 到容器 stdout/stderr

由于 Laravel 本身不直接写 stdout，最可靠、轻量且符合 12-factor 原则的方式是：在容器启动后，后台运行 tail -f 持续输出日志文件内容到标准流。

▪ Docker Compose 场景（推荐）

在 docker-compose.yml 的 PHP 服务中添加 entrypoint 或 command（覆盖默认启动逻辑）：

services:
  app:
    image: travellist
    # ... 其他配置
    entrypoint: ["/bin/sh", "-c"]
    command: |
      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

? 说明：/proc/1/fd/2 是容器主进程（PID 1，即 php-fpm）的 stderr 文件描述符，> 重定向确保日志进入容器标准错误流，docker logs 即可捕获。

▪ Kubernetes 场景（如原答案所示）

使用 lifecycle.postStart 确保日志流在容器就绪后立即启动：

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

⚠️ 注意事项：

• 确保日志目录权限正确（容器内用户需有读写权限）：可在 Dockerfile 中添加 RUN chown -R www-data:www-data /var/www/storage/logs
• 不要使用 tail -f 直接替代主进程（如 tail -f laravel.log 作为唯一命令），否则容器会因主进程退出而终止。
• 避免在 Dockerfile 中用 CMD ["tail", "-f", "..."]，这会覆盖 php-fpm，导致 Web 服务不可用。

✅ 验证是否生效

1. 触发一次 Artisan 错误：

   docker exec -it travellist-app php artisan nonexistent:command

2. 实时查看容器日志：

   docker logs -f travellist-app

   ✅ 正确输出应包含类似以下内容（而非仅 FPM 启动日志）：

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

通过以上三步，Laravel 日志即可无缝接入 Docker/K8s 原生日志收集体系（如 Fluentd、Filebeat、Elasticsearch），实现集中化、结构化与告警联动，大幅提升生产环境排障效率。

终于介绍完啦！小伙伴们，这篇关于《LaravelDocker输出日志到stdout方法》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！