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

如果您在开发 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中文网其它相关文章!