laravel Telescope通过composer安装并迁移数据库后启用,可在本地环境监控请求、异常、sql查询等信息,提升调试效率。

Laravel Telescope 是 Laravel 官方提供的强大调试工具,能帮助开发者监控请求、异常、数据库查询、队列任务、邮件、通知等信息。它非常适合在本地或测试环境中使用,提升开发效率。
安装 Laravel Telescope
要在项目中安装 Telescope,需通过 Composer 安装扩展包,并发布资源文件。
- 运行 Composer 命令安装:
composer require laravel/telescope –dev
- 安装 Telescope 到项目:
php artisan telescope:install
这会创建 Telescope 的迁移文件和配置文件。
- 执行数据库迁移:
php artisan migrate
Telescope 需要数据库存储日志数据,迁移会创建所需的表。
配置访问权限(可选)
默认情况下,Telescope 只在本地环境开放。如果需要自定义访问逻辑,可以在 app/Providers/TelescopeServiceProvider 中修改 gate 方法。
例如,允许特定邮箱的开发者访问:
gate('viewTelescope', function ($user) { return in_array($user->email, [ 'dev@example.com' ]); });
启用监控项
Telescope 支持多种监控类型,默认大多已开启。你可以在 config/telescope.php 中调整。
常见监控包括:
- Requests:查看所有 http 请求参数、头信息、响应码
- Queries:记录 SQL 查询语句和执行时间,便于发现 N+1 问题
- Exceptions:自动捕获未处理异常
- Mail:预览发送的邮件内容(不真正发送)
- Jobs & Notifications:跟踪队列任务和通知发送情况
开发中的实用调试技巧
你可以主动记录调试信息,比如在控制器中添加临时日志:
use IlluminateSupportFacadesTelescope; Telescope::recordDump(collect(['name' => 'John', 'age' => 25]));
然后在 /telescope/dumps 页面查看结构化数据输出,比 dd() 更友好。
当发现慢查询时,进入 Queries 标签页,可直接看到绑定参数和执行时间,快速定位性能瓶颈。
基本上就这些。安装后访问 /telescope 就能看到界面。注意不要在生产环境启用,避免敏感信息泄露。
以上就是Laravel Telescope怎么安装和用于项目调试的详细内容,更多请关注php中文网其它相关文章!