Laravel 调试工具 laravel-debugbar使用介绍

作者：袖梨 2022-06-25

给 Laravel 项目安装了 debugbar 调试工具，在 debug 模式下打开页面底部会出现一个工具条，点开可以查看各项性能统计，最重要的是打印页面执行的 sql 语句和调试内容。下面利用 debugbar 工具找到一个 sql 查询的优化点。

优化页面 sql 查询

这里有两个模型，目的地模型和游记模型，他们是一对多的关系，在目的地模型 Destination.php 的 Model 中关系定义如下：

PHP

/**
* 定义目的地-游记的一对多关系
* @return IlluminateDatabaseEloquentRelationsHasMany
*/
public function travel()
{
return $this->hasMany(Travel::class, 'destination_id');
}

为了统计每个目的地下有多少篇游记，用到了 Laravel 模型很好用的一个特性 appends，定义 appends 数组就是自定义了表字段：

PHP

/**
* 自定义字段
* @var array
*/
protected $appends = [
    'url',
    'first_travel_url',
    'total',
];

这里 total 指的就是目的地下一共有多少篇游记，优化前的代码是这样的：

/**
* 目的地游记数
* @return mixed
*/
public function getTotalAttribute()
{
return $this->travel()->count();
}
这样就导致遍历目的地查询游记的总数，增加 sql 语句频次。这本来是个很好的特性，但是如果要额外查询数据库可能会增加查询开销。debugbar 工具在页面上打印了该页面执行的所有 sql 语句，如图：

显然这里需要进行优化，需要用 group by 目的地的方式统计，只需要一条 sql 语句就可以了。

Laravel 中使用
用 group by 进行统计

在游记模型 Travel.php 的 Model 中增加一个方法：

/**
* 获取每个目的地的游记总数
* @return array
*/
public function getTravelNumsGroupByDestination()
{
    $travelNums = [];
    $result = $this->groupBy('destination_id')->get(['destination_id', DB::raw('count(*) as total')]);
    foreach ($result as $item) {
        $travelNums[$item->destination_id] = $item->total;
    }
    return $travelNums;
}
这里 $result 返回的是一个 Collection 对象，里面是 Travel 类的集合，实际上执行的 sql 语句是：select destination_id, count(*) as total from travel group by destination_id

group-by-select-count

在页面控制器 TravelController.php 的 index 方法中调用这个方法，然后赋值给模板即可。

PHP

/**
* 游记首页
* @return IlluminateContractsViewFactory|IlluminateViewView
*/
public function index()
{
    $data = Cache::remember('travel.index', self::CACHE_TIME, function () {
        $destinationList = $this->destination->getList(12);
        $travelList = $this->travel->latest('begin_date')->take(12)->get();
        $travelNums = $this->travel->getTravelNumsGroupByDestination();
        return [
            'destinationList' => $destinationList,
            'travelList' => $travelList,
            'travelNums' => $travelNums
        ];
    });
    return view('travel.index', $data);
}
这里把数据库的相关查询结果进行了缓存，只有在缓存过期会查询数据库。