Yii2如何记录SQL查询？适配PostgreSQL的调试配置方案

嘿，我完全懂你想要把所有执行的SQL抓下来调试的需求——Yii1的老方法确实在Yii2里行不通了，给你几个适配Yii2的实用方案，和你用PostgreSQL完全无关，而且大部分都能在common/config/main-local.php里配置搞定：

方案1：通过日志组件记录所有SQL到文件 #

直接在你的common/config/main-local.php的components配置里，给log组件添加一个专门的日志目标，用来捕获所有数据库查询：

return [
    // ... 其他配置
    'components' => [
        // ... 其他组件
        'log' => [
            'traceLevel' => YII_DEBUG ? 3 : 0,
            'targets' => [
                // 原有日志目标（比如默认的错误日志）
                [
                    'class' => 'yii\log\FileTarget',
                    'levels' => ['error', 'warning'],
                ],
                // 新增SQL查询专属日志目标
                [
                    'class' => 'yii\log\FileTarget',
                    'categories' => [
                        'yii\db\Command::query',
                        'yii\db\Command::execute',
                    ],
                    'levels' => ['info', 'trace'],
                    'logFile' => '@runtime/logs/sql_queries.log',
                    'logVars' => [], // 避免日志混入过多无关变量，保持SQL内容清晰
                ],
            ],
        ],
    ],
];

配置生效后，所有执行的SQL（包括查询、插入、更新等操作）都会被记录到runtime/logs/sql_queries.log文件中。如果需要查看绑定的参数详情，把levels设为trace即可，日志里会完整显示带参数的SQL执行过程，复制出来就能直接在PostgreSQL工具里测试。

方案2：用Yii2调试面板（Debug Module）可视化查看SQL #

这是开发环境最便捷的方式，直接用Yii2自带的调试模块，能直观看到所有SQL，还能一键复制：

1. 在common/config/main-local.php里启用debug模块：

return [
    // ... 其他配置
    'modules' => [
        'debug' => [
            'class' => 'yii\debug\Module',
            'allowedIPs' => ['127.0.0.1', '::1'], // 允许访问调试面板的IP，根据你的开发环境调整
        ],
    ],
];

2. 启动项目后，访问http://你的域名/index.php?r=debug进入调试面板，找到左侧的Database选项卡：
   • 每条SQL都会显示执行时间、绑定参数等细节
   • 点击每条SQL右侧的复制图标，就能直接拿到替换好参数的完整SQL，粘贴到PostgreSQL工具里就能测试

方案3：手动打印单个查询的SQL #

如果只是想调试某一段代码里的SQL，直接用getRawSql()方法就能拿到最终可执行的SQL：

比如处理ActiveQuery时：

$query = User::find()->where(['status' => 1]);
// 打印最终拼接好参数的SQL
echo $query->createCommand()->getRawSql();

处理原生SQL时：

$command = Yii::$app->db->createCommand('SELECT * FROM user WHERE status = :status', [':status' => 1]);
echo $command->getRawSql();

输出的内容就是可以直接复制到数据库工具中执行的完整SQL。

内容的提问来源于stack exchange，提问作者Roby Sottini