Laravel Telescope可增强调试能力，通过Composer安装并发布资源文件后执行数据库迁移，启用中间件配置访问权限，可在TelescopeServiceProvider中设置邮箱白名单，通过config/telescope.php控制监控类型如仅记录请求与异常，结合.env的TELESCOPE_ENABLED控制开关，访问http://localhost:8000/telescope查看日志、SQL等信息，支持使用Telescope::recordLog等方法手动记录自定义数据。

如果您在开发 Laravel 应用时希望获得更强大的调试能力，Laravel Telescope 是一个专为开发者设计的调试工具，能够监控请求、异常、数据库查询、邮件发送等应用行为。以下是配置和使用 Telescope 的具体步骤。

本文运行环境：MacBook Pro，macOS Sonoma

一、安装 Laravel Telescope

Telescope 通过 Composer 包管理器进行安装，需确保项目已正确配置 Composer 环境。安装后会自动注册服务提供者（在非生产环境下）。

1、打开终端并进入 Laravel 项目根目录，执行以下命令安装 Telescope：

composer require laravel/telescope

2、安装完成后，发布 Telescope 的资源文件，包括配置文件和数据库迁移文件：

php artisan telescope:install

3、执行数据库迁移命令，创建存储监控数据的数据表：

php artisan migrate

二、启用 Telescope 中间件

Telescope 提供了 Web 界面用于查看调试信息，需通过中间件控制访问权限。默认情况下仅允许本地访问，可在配置中自定义授权逻辑。

1、确保 App\Providers\TelescopeServiceProvider 已注册到应用的服务提供者中。

2、打开 app/Providers/TelescopeServiceProvider.php 文件，在 gate 方法中定义允许访问 Telescope 的用户条件。

3、例如，允许特定邮箱的用户访问，可修改 gate 方法返回值如下：

return request()->user() ? request()->user()->email == 'admin@example.com' : false;

三、配置监控选项

Telescope 允许按类型开启或关闭特定监控项，如请求、异常、缓存、队列任务等，以减少性能开销并聚焦关键信息。

1、打开配置文件 config/telescope.php，找到 entries 配置项。

2、根据需要设置监听的类别，例如关闭 Redis 和 Cache 的记录：

'entries' => [ App\Telescope\Entries\EntryType::REQUEST, App\Telescope\Entries\EntryType::EXCEPTION ],

3、也可通过环境变量控制是否启用 Telescope，在 .env 文件中设置：

TELESCOPE_ENABLED=true

四、访问 Telescope 调试界面

安装并配置完成后，可通过指定路由访问 Telescope 提供的 Web 控制台，查看详细的运行日志与调试数据。

1、启动 Laravel 开发服务器（如未运行）：

php artisan serve

2、在浏览器中访问以下地址：

http://localhost:8000/telescope

3、登录具有访问权限的账户，即可查看请求列表、异常堆栈、SQL 查询语句等详细信息。

五、自定义数据记录

除了自动收集的数据外，Telescope 支持手动记录自定义信息，便于在复杂逻辑中插入调试标记。

1、在代码中使用 Telescope::record... 方法家族记录数据，例如记录一条日志：

use Laravel\Telescope\Telescope; Telescope::recordLog(\Illuminate\Support\Facades\Log::build(['message' => 'Custom debug message']));

2、记录自定义事件或性能指标时，可调用对应方法如 recordQuery、recordDump 等。

3、使用 dump() 函数输出变量内容，Telescope 会自动捕获并在 Dumps 标签页显示。