在 Laravel 开发中，调试是一个不可避免的过程。传统的调试方法，如 dd() 或 var_dump()，虽然简单直接，但在复杂的应用中，这些方法可能会导致“调试地狱”——大量的输出信息难以管理，甚至可能影响应用的正常运行。为了提升调试效率，Spatie 提供了一个强大的调试工具包：Laravel-Ray。
Laravel-Ray 是一个 Laravel 专用的调试工具包，它允许开发者通过 Ray 桌面应用实时查看调试信息。Ray 是一个跨平台的调试工具，支持 macOS、Windows 和 Linux。通过 Laravel-Ray，开发者可以在不中断应用运行的情况下，实时查看变量、查询、日志、事件等信息。
安装 Ray 桌面应用
首先，你需要下载并安装 Ray 桌面应用。你可以从 Ray 官方网站 下载适合你操作系统的版本。
安装 Laravel-Ray 包
在你的 Laravel 项目中，通过 Composer 安装 Laravel-Ray 包：
composer require spatie/laravel-ray
发布配置文件
安装完成后，你可以通过以下命令发布配置文件：
php artisan vendor:publish --provider="Spatie\LaravelRay\RayServiceProvider"
这将在 config 目录下生成一个 ray.php 配置文件，你可以在这里配置 Ray 的行为。
配置 Ray
在 .env 文件中，添加以下配置：
RAY_ENABLED=true
RAY_HOST=127.0.0.1
RAY_PORT=23517
RAY_ENABLED：是否启用 Ray。RAY_HOST：Ray 应用的主机地址，通常为 127.0.0.1。RAY_PORT：Ray 应用的端口，默认为 23517。安装并配置完成后，你可以开始使用 Laravel-Ray 进行调试。以下是一些常见的用法：
发送变量到 Ray
你可以使用 ray() 函数将变量发送到 Ray 应用：
$data = ['name' => 'John', 'age' => 30];
ray($data);
在 Ray 应用中，你将看到 $data 的内容。
调试查询
Laravel-Ray 可以自动捕获并显示数据库查询。你只需在代码中启用查询调试：
DB::enableQueryLog();
User::where('active', 1)->get();
ray(DB::getQueryLog());
你可以在 Ray 应用中查看执行的 SQL 查询及其执行时间。
调试事件
你可以使用 ray() 函数来调试事件：
Event::listen('*', function ($eventName, array $data) {
ray($eventName, $data);
});
这样，所有触发的事件都会在 Ray 应用中显示。
调试日志
Laravel-Ray 还可以捕获并显示日志信息。你可以在 config/logging.php 中配置 Ray 作为日志通道：
'channels' => [
'ray' => [
'driver' => 'ray',
],
],
然后，在代码中使用 Log::channel('ray')->info('This is a log message'); 来发送日志到 Ray。
调试异常
你可以使用 ray() 函数来捕获并显示异常：
try {
// Some code that may throw an exception
} catch (\Exception $e) {
ray($e);
}
异常信息将在 Ray 应用中显示。
颜色标记
你可以为不同的调试信息添加颜色标记，以便更好地区分：
ray('This is a message')->color('green');
分组调试
你可以将相关的调试信息分组显示：
ray()->group('User Registration', function () {
ray('User created');
ray('Email sent');
});
暂停应用
你可以在调试时暂停应用的执行：
ray()->pause();
这在需要逐步调试时非常有用。
通过使用 Spatie/Laravel-Ray，你可以显著提升 Laravel 应用的调试效率。它不仅提供了丰富的调试功能，还能在不中断应用运行的情况下实时查看调试信息。告别传统的 dd() 和 var_dump()，拥抱更高效、更优雅的调试方式吧！
希望这篇文章能帮助你更好地理解和使用 Laravel-Ray，提升你的开发效率！