laravel怎么监听数据库查询事件_laravel数据库查询事件监听方法-Laravel-PHP中文网

laravel怎么监听数据库查询事件_laravel数据库查询事件监听方法

穿越時空

发布： 2025-11-09 09:11:02

原创

156人浏览过

可通过事件系统监听 Laravel 数据库查询，首先使用 DB::listen 在 AppServiceProvider 中捕获所有 SQL 执行信息并写入日志文件，为保持结构清晰可创建独立的 DatabaseQueryServiceProvider 并注册到配置中，生产环境应添加执行时间条件（如超过 100ms）以减少日志量，同时推荐结合 Laravel Telescope 实现可视化监控，通过安装包、发布资源及迁移后访问 /telescope 查看详细查询数据。

laravel怎么监听数据库查询事件_laravel数据库查询事件监听方法

如果您在开发 Laravel 应用时需要追踪数据库查询行为，例如记录慢查询、调试 SQL 执行或监控特定模型的查询操作，可以通过事件系统来捕获数据库查询的执行过程。以下是实现数据库查询事件监听的具体方法。

本文运行环境：MacBook Pro，macOS Sonoma

一、使用 DB::listen 监听所有查询

该方法可以全局监听应用程序中所有执行的 SQL 查询语句，适用于调试和性能分析。通过注册一个监听器，可以在每次查询执行后获取 SQL、绑定参数和执行时间。

1、打开 AppServiceProvider.php 文件，在 boot 方法中添加 DB::listen 回调。

2、引入 DB 门面：use Illuminate\Support\Facades\DB;。

3、在 boot 方法内添加如下代码块：

DB::listen(function ($query) {
   file_put_contents(storage_path('logs/sql.log'),
      "Time: {$query->time}ms | SQL: {$query->sql} | Bindings: ".json_encode($query->bindings)."\n",
   FILE_APPEND);
});

4、确保 storage/logs/ 目录存在且可写，否则日志将无法生成。

二、基于事件服务提供者分离监听逻辑

为了保持代码结构清晰，建议将数据库查询监听逻辑独立到专门的服务提供者中，避免 AppServiceProvider 过于臃肿。

1、使用 Artisan 命令创建新的服务提供者：php artisan make:provider DatabaseQueryServiceProvider。

2、在新创建的 DatabaseQueryServiceProvider.php 中，于 boot 方法内编写与 DB::listen 相同的监听逻辑。

3、将该服务提供者注册到 config/app.php 的 providers 数组中：'providers' => [... App\Providers\DatabaseQueryServiceProvider::class]。

4、重新加载配置缓存：php artisan config:clear，使注册生效。

三、条件性记录查询以减少日志量

在生产环境中直接记录所有查询会导致日志文件迅速膨胀，因此可通过设置阈值仅记录执行时间较长的查询。

1、修改 listen 回调中的判断逻辑，加入执行时间过滤条件。

2、示例代码如下：

DB::listen(function ($query) {
   if ($query->time > 100) { // 仅记录超过100毫秒的查询
      file_put_contents(storage_path('logs/slow_queries.log'),
         "Slow Query ({$query->time}ms): {$query->sql} | ".json_encode($query->bindings)."\n",
         FILE_APPEND);
   }
});

3、根据实际性能需求调整时间阈值，如 50ms 或 200ms。