Hyperf MySQL慢查询日志怎么开？-php教程-PHP中文网

Hyperf 默认不开启 MySQL 慢查询日志，需在 MySQL 服务端配置 slow_query_log 等参数启用；Hyperf 仅可通过监听 QueryExecuted 事件在应用层记录超时 SQL。

hyperf mysql慢查询日志怎么开？

Hyperf 默认不会开启 MySQL 慢查询日志，因为它是应用层框架，不直接控制 MySQL 服务本身的日志开关。真正要开慢查询日志，得从 MySQL 服务端配置入手；而 Hyperf 可以配合做查询耗时监控和记录（比如通过 DB 组件事件或中间件），但不是传统意义的“MySQL 慢查询日志”。

MySQL 服务端开启 slow_log

这是最标准的慢查询日志方式，记录所有超过 long_query_time 的 SQL 到文件中：

登录 MySQL：执行 mysql -u root -p
临时启用（重启失效）：
SET GLOBAL slow_query_log = ON;
SET GLOBAL long_query_time = 1.0;
SET GLOBAL slow_query_log_file = '/var/log/mysql/mysql-slow.log';
永久生效：编辑 MySQL 配置文件（如 /etc/my.cnf 或 /etc/mysql/mysql.conf.d/mysqld.cnf），在 [mysqld] 下添加：

slow_query_log = ON
long_query_time = 1.0
slow_query_log_file = /var/log/mysql/mysql-slow.log
log_queries_not_using_indexes = OFF  # 可选：只记录没走索引的慢查

保存后重启 MySQL：sudo systemctl restart mysql（或 mysqld）

Hyperf 中监听慢查询（应用层辅助）

Hyperf 的 Db 组件支持事件监听，可在查询耗时超标时主动记录日志（不依赖 MySQL 服务日志）：

MySQL8 CRM Schema Design Expert

面向 CRM 系统的 MySQL 8 数据库模式设计。当用户需要为客户关系管理（CRM）系统设计、评审、优化或生成数据库模式时，应使用此项技能。

下载

在 config/autoload/listeners.php 中注册监听器：

use Hyperf\Database\Commands\Listeners\SlowQueryListener;
return [
    Hyperf\Database\Events\QueryExecuted::class => [
        \App\Listener\SlowQueryListener::class,
    ],
];

然后创建 app/Listener/SlowQueryListener.php：

namespace App\Listener;
<p>use Hyperf\Database\Events\QueryExecuted;
use Hyperf\Event\Annotation\Listener;
use Hyperf\Event\Contract\ListenerInterface;
use Psr\Log\LoggerInterface;
use Hyperf\Utils\Arr;</p><h1>[Listener]</h1><p>class SlowQueryListener implements ListenerInterface
{
public function __construct(private LoggerInterface $logger)
{
}</p><pre class="brush:php;toolbar:false;">public function listen(): array
{
    return [
        QueryExecuted::class,
    ];
}

public function process(object $event): void
{
    if ($event instanceof QueryExecuted && $event->time > 1000) { // 超过 1000ms 认为慢
        $sql = $event->sql;
        $bindings = $event->bindings;
        $time = round($event->time, 2);
        $this->logger->warning('Slow SQL detected', [
            'sql' => $sql,
            'bindings' => $bindings,
            'time_ms' => $time,
            'connection' => $event->connectionName,
        ]);
    }
}

}