企业官网建设流程全解析

PHP 日志格式 ≠ JSON 格式—— 二者是可选关系，而非等同关系。

• 传统 PHP 日志：纯文本（如error_log、Monolog 默认格式）
• JSON 日志：结构化日志的一种可选格式，需显式配置

是否使用 JSON 取决于日志消费场景（如 ELK、Splunk 需要结构化数据）。

一、核心区别：文本 vs 结构化

💡核心认知：
JSON 日志 = 为机器优化的结构化格式，文本日志 = 为人类优化的可读格式

二、PHP 日志实现对比

▶ 1.Laravel 默认文本日志

// config/logging.php'channels'=>['stack'=>['driver'=>'stack','channels'=>['single'],],'single'=>['driver'=>'single','path'=>storage_path('logs/laravel.log'),'level'=>'debug',],],

• 输出示例：

  [2026-01-27 10:00:00] local.ERROR: Failed to connect to database {"userId":123}

▶ 2.Laravel JSON 日志配置

// config/logging.php'single_json'=>['driver'=>'single','path'=>storage_path('logs/laravel.json'),'level'=>'debug','formatter'=>\Monolog\Formatter\JsonFormatter::class,],

• 输出示例：

  {"message":"Failed to connect to database","context":{"userId":123},"level":400,"level_name":"ERROR","channel":"local","datetime":"2026-01-27T10:00:00.000000Z","extra":[]}

▶ 3.原生 PHP 错误日志

• error_log()：始终为文本格式
• php-fpm.log：文本格式（无法直接改为 JSON）

三、工程实践：何时用 JSON？

▶ 1.必须用 JSON 的场景

• 集中式日志系统：
  • ELK（Elasticsearch + Logstash + Kibana）
  • Grafana Loki + Promtail
• 自动化分析：
  • 需要按user_id、request_id聚合日志

▶ 2.推荐用文本的场景

• 本地开发/调试：
  • 人类直接阅读（tail -f laravel.log）
• 简单服务器部署：
  • 无日志收集系统

▶ 3.混合策略（最佳实践）

// config/logging.php'channels'=>[// 本地保留文本日志（方便调试）'daily'=>['driver'=>'daily','path'=>storage_path('logs/laravel.log'),'level'=>'debug','days'=>14,],// 同时输出 JSON 到标准输出（供 Docker/Logstash 捕获）'stderr'=>['driver'=>'monolog','handler'=>StreamHandler::class,'with'=>['stream'=>'php://stderr',],'formatter'=>JsonFormatter::class,],],

四、避坑指南

五、终极心法

**“日志不是记录，
而是观测的透镜——

• 当你用文本，
  你在服务人类；
• 当你用 JSON，
  你在赋能机器；
• 当你混合输出，
  你在平衡两端。

真正的可观测性，
始于对消费端的敬畏，
成于对细节的精控。”

结语

从今天起：

1. 本地开发用文本日志
2. 生产环境输出 JSON 到 stderr
3. 关键字段（如 request_id）必须包含在 JSON 中

因为最好的日志，
不是格式之争，
而是精准匹配消费场景的每一比特。