Laravel Telescope怎么安装和用于项目调试

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

Laravel Telescope 是 Laravel 官方提供的强大调试工具，能帮助开发者监控请求、异常、数据库查询、队列任务、邮件、通知等信息。它非常适合在本地或测试环境中使用，提升开发效率。

安装 Laravel Telescope

要在项目中安装 Telescope，需通过 Composer 安装扩展包，并发布资源文件。

composer require laravel/telescope --dev

php artisan telescope:install

这会创建 Telescope 的迁移文件和配置文件。

php artisan migrate

Telescope 需要数据库存储日志数据，迁移会创建所需的表。

配置访问权限（可选）

默认情况下，Telescope 只在本地环境开放。如果需要自定义访问逻辑，可以在 app/Providers/TelescopeServiceProvider 中修改 gate 方法。

白瓜面试

白瓜面试 - AI面试助手,辅助笔试面试神器

40

查看详情

例如，允许特定邮箱的开发者访问：

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 Illuminate\Support\Facades\Telescope;

Telescope::recordDump(collect(['name' => 'John', 'age' => 25]));

然后在 /telescope/dumps 页面查看结构化数据输出，比 dd() 更友好。

当发现慢查询时，进入 Queries 标签页，可直接看到绑定参数和执行时间，快速定位性能瓶颈。

基本上就这些。安装后访问 /telescope 就能看到界面。注意不要在生产环境启用，避免敏感信息泄露。

以上就是Laravel Telescope怎么安装和用于项目调试的详细内容，更多请关注php中文网其它相关文章！