Laravel Telescope 是一個強大的調試工具，通過實時監(jiān)控應用內部運作來提升開發(fā)效率。安裝時使用命令 composer require laravel/telescope 和 php artisan telescope:install，并運行遷移以完成配置；默認僅在本地環(huán)境啟用，可在 TelescopeServiceProvider 中調整環(huán)境限制，也可在 config/telescope.php 中自定義數(shù)據(jù)記錄范圍。其核心功能包括：1. 實時監(jiān)控請求與異常，顯示路由、輸入數(shù)據(jù)、會話、響應狀態(tài)等，并自動記錄異常信息，便于排查錯誤；2. 查詢性能分析，展示所有 SQL 查詢及執(zhí)行時間，識別重復或耗時查詢，幫助優(yōu)化數(shù)據(jù)庫操作；3. 監(jiān)控任務、事件和郵件，查看事件觸發(fā)情況、作業(yè)分派狀態(tài)以及郵件內容，無需實際發(fā)送即可調試郵件內容。這些功能使 Laravel Telescope 成為開發(fā)過程中不可或缺的輔助工具。

When you're building or maintaining a Laravel app, having insight into what’s going on under the hood can save you hours of debugging. That’s where Laravel Telescope comes in — it's a powerful tool for monitoring and debugging your application in real time.

Here are some practical ways to make the most out of Laravel Telescope during development and debugging.

Installing and Enabling Laravel Telescope

Before you can use Telescope, you need to install it via Composer:

composer require laravel/telescope

Then run the installation command:

php artisan telescope:install

This creates a TelescopeServiceProvider and publishes all necessary configuration files and migrations. Run your migrations with:

php artisan migrate

By default, Telescope is only available in the local environment. If you want to enable it in other environments (not recommended for production), update the gate() method inside the App\Providers\TelescopeServiceProvider.

You can also fine-tune which data gets recorded by editing the watchers array in config/telescope.php. For example, disable logging of Redis commands if you don’t need them.

Monitoring Requests and Exceptions in Real Time

One of the most useful features of Telescope is its ability to log every incoming request along with detailed information about what happened during that request.

• Each entry includes the route called, input data, session contents, cookies, response status, and more.
• It also logs any exceptions thrown during the request lifecycle, making it easy to spot errors without digging through logs manually.

If you’re troubleshooting a 500 error or trying to understand why a specific request isn't behaving as expected, just open up Telescope, find the relevant request, and inspect the timeline and exception tab.

Use this feature to:

• See exactly what input was sent to a controller
• Track down unhandled exceptions or model not found errors
• Check how long each part of the request took to execute

Debugging Queries and Performance Bottlenecks

The Queries tab in Telescope shows every SQL query executed during a request, including execution time and bindings.

This helps you identify:

• Duplicate queries (especially helpful when dealing with N 1 issues)
• Long-running queries that might need indexing
• Raw SQL statements with parameter values already substituted

For example, if you see a query repeated multiple times within one request, it could mean you're looping over a relationship without eager loading it first. Telescope makes spotting these kinds of performance issues much easier than scanning through log files.

You can also toggle between "Slow" and "All" queries to focus on those taking longer than a specified threshold (default is 100ms).

Watching Jobs, Events, and Mail in Development

While developing features like email notifications or background job processing, it’s often hard to know what’s actually being triggered behind the scenes.

Telescope gives you visibility into:

• Which events were fired and who listened to them
• What jobs were dispatched and whether they succeeded
• Full details of mailables, including rendered views and recipient info

This means you can:

• Confirm event listeners are working without sending real emails
• See the payload passed to queued jobs before they run
• Debug mail content directly in Telescope instead of using tools like Mailtrap during local testing

Just keep in mind, this kind of data should never be exposed in production. Telescope is meant for development use, so always ensure it's properly gated in non-local environments.

That’s basically it. Laravel Telescope doesn’t replace traditional debugging tools like Xdebug or logging, but it adds a layer of real-time visibility that makes everyday development tasks faster and less error-prone. It's especially handy when you're deep in the weeds and need to quickly understand what’s happening across requests, queries, and background processes.

以上是利用Laravel望遠鏡進行調試和監(jiān)視的詳細內容。更多信息請關注PHP中文網其他相關文章！