Laravel Blanket 安装与配置指南

项目简介

Laravel Blanket 是一款专为 Laravel 应用设计的扩展包，旨在提供一个仪表盘来查看您的HTTP客户端请求的详情，包括请求和响应日志，并允许您直接从控制台重试任何请求。适用于快速调试、性能监控及安全审计等多个场景。

1. 目录结构及介绍

以下是 laravel-blanket 项目的主要目录结构及其简述：

• config: 包含 blanket.php 配置文件，用于自定义 Blanket 的行为。
• database/migrations: 提供数据库迁移文件，用于存储HTTP请求日志。
• src: 主代码库，包含服务提供者和其他主要逻辑实现。
• public: 若有前端资源，可能会存放于此，但该扩展可能依赖其他方式发布前端资源。
• routes: 可能包含为 Blanket 创建的特定路由。
• .editorconfig, .gitattributes, .gitignore: 版本控制相关配置文件。
• tests: 单元测试文件夹。
• CHANGELOG.md, LICENSE.md, README.md: 分别是更改日志、许可协议和快速入门文档。

2. 启动文件介绍

虽然 Laravel Blanket 不直接提供一个“启动”文件，其激活和运行的核心在于安装后的自动服务提供者注册及执行以下关键步骤：

• 安装：通过 Composer 添加依赖 (composer require ahmadwaleed/laravel-blanket)。
• 配置：发布资产和配置（php artisan blanket:wrap 和 php artisan vendor:publish），这一步会创建或更新相关配置文件，并准备前端资源。
• 数据库迁移：执行必要的数据库迁移 (php artisan migrate) 来创建日志表。
• 访问仪表盘：配置完成后，通过配置中设定的路径（默认是 /blanket）访问仪表盘。

3. 项目配置文件介绍

config/blanket.php

此配置文件控制 Blanket 行为的关键参数：

• enabled: 控制是否启用仪表盘，可以通过环境变量调整。
• hide_sensitive_data: 允许指定哪些请求和响应字段应视为敏感并隐藏，支持数组配置，可以隐藏 headers、request 及 response 中的特定键值。
• path: 设置访问仪表盘的URL路径，默认为 /blanket。
• middlewares: 指定附加到 Blanket 路由的所有中间件，允许自定义访问控制。
• log_response_limit: 设置响应内容的最大日志长度限制，防止过大日志导致的问题。
• logs_per_page: 控制每页显示的日志条目数量，影响性能和用户体验。
• prune_logs_duration: 日志自动清理的时间周期，比如保留一个月内的日志。

确保仔细调整这些配置项，以最佳匹配您的应用程序需求。完成配置后，Laravel Blanket 就能按您的设置运行，提供强大的HTTP请求监控能力。