yesccx/laravel-log-viewer

Log Viewer

v1.1.1 2025-12-10 03:50 UTC

Requires

• php: ^8.1.0
• opcodesio/log-viewer: ^3.21

Requires (Dev)

• phpstan/phpstan: ^2.1

MIT

• yesccx

• laravel
• log viewer
• yesccx

README

一个基于 opcodesio/log-viewer 的 Laravel 日志查看器扩展包，简化配置开箱即用。

功能特性

• 🚀 基于 opcodesio/log-viewer 重新构建，不依赖外部JS、CSS资源
• 🔐 接入权限认证，保障使用安全
• 📦 几乎开箱即用，简单集成
• 💾 支持下载日志文件，快速备份

环境要求

• PHP >= 8.1
• Laravel >= 9.0

安装

通过 Composer 安装：

composer require yesccx/laravel-log-viewer

快速开始

1. 配置环境变量

# 启用面板
LOG_VIEWER_ENABLED=true

# 认证令牌
LOG_VIEWER_AUTH_TOKEN=xxxx

# 允许非HTTPS下使用COOKIE(认证令牌依赖此配置)
SESSION_SECURE_COOKIE=null

1. 在浏览器中访问面板

http(s)://xxx/innerapi/log-viewer?token=xxxx

1. 一切就绪

完整配置

基础配置

参考 opcodesio/log-viewer 配置文件

权限认证

内置了认证机制，默认为开启状态，通过以下环境变量控制：

# 启用认证(默认启用)
LOG_VIEWER_AUTH_ENABLED=true

# 认证令牌
LOG_VIEWER_AUTH_TOKEN=

访问路径

默认的访问路由为innerapi/log-viewer，通过以下环境变量控制：

LOG_VIEWER_ROUTE_PATH=innerapi/log-viewer

日志收集

默认只收集 storage/logs 目录下的日志及 /var/log/supervisor/*.log 日志，可通过以下 环境变量追加：

# 多个用半角逗号分隔
LOG_VIEWER_INCLUDE_FILES=

开发调试

原包更新时，通过 npm install && npm run production 结合 webpack.min.js 重新构建静态资源.

变更日志

请查看 CHANGELOG 了解更多关于版本更新的信息。