Debian上Laravel的日志管理技巧

Debian上Laravel日志管理实用技巧

一基础配置与查看

默认日志目录为：storage/logs，常用查看命令：ls -la storage/logs、tail -f storage/logs/laravel.log。
在 .env 中设置日志通道与级别：LOG_CHANNEL=single（或 daily）、LOG_LEVEL=debug（生产建议 error/warning）。
生产务必关闭调试：APP_DEBUG=false，避免将敏感信息输出到页面。
按需调整通道，例如在 config/logging.php 使用 daily 通道并设置保留天数：'days' => 14。

二日志轮转与清理

应用内轮转（Laravel 自带）：使用 daily 通道并设置保留天数（如 14 天），超过期限自动清理旧日志。
系统级轮转（推荐）：使用 logrotate 管理 Laravel 日志文件，示例配置 /etc/logrotate.d/laravel：
```
/var/www/your_project/storage/logs/*.log {
    daily
    missingok
    rotate 14
    compress
    delaycompress
    notifempty
    create 0640 www-data adm
}
```
说明：daily 每天轮转；rotate 14 保留 14 份；compress 压缩旧日志；create 0640 www-data adm 以 www-data 身份新建日志文件。
手动清理（谨慎）：php artisan log:clear 清空日志；如需保留最近一个：php artisan log:clear --keep-last。

三权限与常见故障排查

确保写入权限：Web/PHP-FPM 通常以 www-data 运行，执行：
sudo chown -R www-data:www-data storage/logs
sudo chmod -R 755 storage/logs
若仍报 “Permission denied / UnexpectedValueException”，多为进程用户与文件属主不一致或权限不足：
- 统一运行用户（如 www-data）执行定时任务：su www-data -s /bin/bash -c "php artisan schedule:run"；
- 避免粗暴的 0777 权限，优先通过用户/组与目录权限解决；
- Laravel 5.6+ 可在 config/logging.php 的 daily 通道设置 permission 项（如 0640）以统一新建文件权限。

四高级用法与架构建议

远程集中日志：在 config/logging.php 配置 stack 通道，将日志同时输出到本地与远程（如 Logstash、rsyslog），便于统一检索与告警。
结构化日志：将日志格式设为 JSON，便于 ELK/EFK 解析与检索。

分级保留策略：将 critical 等高优先级日志单独输出并延长保留期，例如：

'stack' => [
    'driver' => 'stack',
    'channels' => ['daily', 'critical'],
],
'critical' => [
    'driver' => 'single',
    'path' => storage_path('logs/critical.log'),
    'level' => 'critical',
    'days' => 90,
],

归档与检索：对历史日志按月/季度压缩归档（如 gzip），使用 zgrep 直接检索压缩包内容，降低成本并提升查询效率。

最新问答

相关标签