告别dd()地狱：如何优雅地调试Laravel应用，使用spatie/laravel-log-dumper让日志更清晰

<code class="bash">composer require spatie/laravel-log-dumper</code>

<pre class="brush:php;toolbar:false;">// app/Http/Controllers/UserController.php

class UserController extends Controller
{
    public function index()
    {
        $users = User::all();
        $requestData = request()->all();
        $someObject = new stdClass();
        $someObject->name = 'Test';
        $someObject->data = ['key' => 'value', 'nested' => [1, 2, 3]];

        // 使用 ld() 调试，不会中断程序执行
        ld('Fetching users', $users->count(), $requestData, $someObject);

        return view('users.index', compact('users'));
    }
}

<pre class="brush:php;toolbar:false;">[2023-10-27 10:30:00] local.INFO: "Fetching users"  
[2023-10-27 10:30:00] local.INFO: 5  
[2023-10-27 10:30:00] local.INFO: array:2 [  
  "param1" => "value1"  
  "param2" => "value2"  
]  
[2023-10-27 10:30:00] local.INFO: stdClass {#1234  
  +name: "Test"  
  +data: array:2 [  
    "key" => "value"  
    "nested" => array:3 [  
      0 => 1  
      1 => 2  
      2 => 3  
    ]  
  ]  
}

<pre class="brush:php;toolbar:false;">// 记录到 error 级别
ld()->error('Something went wrong!', $exception->getMessage(), $context);

// 记录到 debug 级别
ld()->debug('Detailed debug info', $complexObject);

// 混合和链式调用
ld()
   ->debug('User registration process started', ['userId' => $user->id])
   ->warning('Potential issue with email service', ['email' => $user->email])
   ->error('Critical failure in payment gateway', $paymentError);

<pre class="brush:php;toolbar:false;">ld('This will be logged.'); // 默认启用，会被记录

ld()->disable(); // 禁用 ld()

ld('This will NOT be logged.'); // 不会被记录

ld()->enable(); // 重新启用 ld()

ld('This will be logged again.'); // 会被记录

<pre class="brush:php;toolbar:false;">foreach (range(1, 5) as $i) {
    // 只有在第三次迭代时才记录
    ld()->enable($i === 3); 
    ld("Current iteration: {$i}");
}
// 输出中只会包含 "Current iteration: 3"

<pre class="brush:php;toolbar:false;">// 开启查询日志，之后的所有查询都会被记录
ld()->logQueries(); 

User::where('status', 'active')->get();
Product::find(1);

// 停止查询日志
ld()->stopLoggingQueries(); 

// 这条查询将不会被记录
Order::all();

<pre class="brush:php;toolbar:false;">ld()->logQueries(function() {
    // 只有这里面的查询会被记录
    $this->processOrder($orderId); 
    $this->updateInventory($productId);
});

// 这条查询不会被记录
Category::all();