Laravel Telescope是一款专为本地开发设计的调试工具,通过composer require laravel/telescope --dev安装并执行php artisan telescope:install和migrate后,可访问/telescope界面查看请求、异常、SQL查询、邮件、队列等实时信息,需在TelescopeServiceProvider中配置访问权限,默认仅限本地,建议结合.env的TELESCOPE_ENABLED控制开关,避免生产环境启用以防止性能损耗与信息泄露。
Laravel Telescope 是 Laravel 官方提供的强大调试与监控工具,特别适合在本地开发环境中使用。它能帮助开发者实时查看请求、异常、数据库查询、队列任务、邮件发送等详细信息,极大提升调试效率。下面介绍如何在本地项目中安装和使用 Telescope 进行开发调试。
Telescope 可通过 Composer 安装到 Laravel 项目中,仅建议在本地或测试环境启用。
安装完成后,Telescope 的前端界面将可通过 /telescope 路径访问(如 http://your-app.test/telescope)。
默认情况下,Telescope 只允许本地访问。你可以在 app/Providers/TelescopeServiceProvider.php 中的 gate 方法内自定义访问逻辑。
例如,只允许本地开发人员访问:Gate::define('viewTelescope', function ($user) {
return in_array($user->email, [
'you@local.dev'
]);
});
若在本地无需登录,可直接设置为返回 true,但上线前务必关闭或限制访问
。
Telescope 提供多个标签页,覆盖开发中的常见调试场景:
这些信息实时刷新,点击任意条目可查看详细上下文,对排查问题非常有帮助。
结合实际开发习惯,可以更高效地使用 Telescope:
注意不要在生产环境开启 Telescope,避免性能损耗和敏感信息泄露。
基本上就这些。合理使用 Laravel Telescope,能让本地调试变得更直观、更高效。不复杂但容易忽略。