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

可通过事件系统监听 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 IlluminateSupportFacadesDB;

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’ => [… AppProvidersDatabaseQueryServiceProvider::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。

四、结合 Laravel Telescope 进行可视化监控

Laravel Telescope 是官方提供的调试工具,能自动收集数据库查询信息,并提供 Web 界面查看,适合开发阶段使用。

1、通过 composer 安装 Telescope:composer require laravel/telescope

2、发布资源文件并执行迁移:php artisan telescope:install && php artisan migrate

3、访问 /telescope 路径即可查看实时数据库查询列表,包括 SQL、执行时间、调用等详细信息。

4、可在 config/telescope.php 中配置数据保留策略和过滤规则。

以上就是laravel怎么监听数据库查询事件_laravel数据库查询事件监听方法的详细内容,更多请关注php中文网其它相关文章!

上一篇
下一篇
text=ZqhQzanResources