Php打印完整sql

admin 2026年02月17日 13:49 105 0

在PHP开发中，打印完整SQL语句常用于调试数据库操作，若使用PDO，可通过捕获预处理语句的SQL模板与绑定参数手动拼接，或利用PDOStatement::queryString获取原始SQL；MySQLi中，直接执行查询前可打印$query变量，若使用ORM框架（如Laravel），可启用查询日志（DB::getQueryLog()）或配置调试模式打印所有执行SQL，此操作能帮助开发者定位SQL语法错误、参数绑定问题及性能瓶颈，确保数据库交互逻辑正确。

PHP打印完整SQL语句的实用方法与技巧

在PHP开发中,数据库操作是核心环节之一，无论是调试SQL错误、优化查询性能，还是排查数据异常，打印完整的SQL语句都是不可或缺的调试手段，本文将详细介绍在PHP中打印完整SQL语句的多种方法，涵盖原生PHP操作、主流框架支持及调试工具辅助，帮助开发者高效定位问题。

为什么需要打印完整SQL语句？

在开发过程中,我们常遇到以下场景需要打印SQL：

调试错误：当SQL执行报错（如语法错误、字段不存在）时，打印完整SQL能快速定位问题；
性能优化：通过分析SQL执行计划（如EXPLAIN结果）或实际执行的SQL，判断是否需要添加索引、优化查询条件；
数据异常排查：当查询结果不符合预期时，打印SQL及参数值，确认是否因参数传递错误或SQL逻辑问题导致；
学习与验证：在复杂查询（如联表、子查询）中，打印SQL能帮助理解框架生成的底层逻辑；
安全审计：在安全审计阶段，检查所有执行的SQL语句，防止SQL注入等安全问题。

原生PHP中打印完整SQL的方法

使用PDO（PHP Data Objects）

PDO是PHP中操作数据库的扩展,支持多种数据库（MySQL、PostgreSQL等），默认情况下，PDO不会直接打印执行的SQL，但可通过以下方式获取：

（1）通过预处理语句参数拼接模拟

PDO预处理语句（prepare + execute）会将SQL模板和参数分开处理，此时可通过拼接SQL模板与参数还原完整SQL：

<?php
$pdo = new PDO('mysql:host=localhost;dbname=test', 'username', 'password');
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
// SQL模板与参数
$sql = "SELECT * FROM users WHERE status = :status AND created_at > :created_at";
$params = [
    ':status' => 1,
    ':created_at' => '2023-01-01'
];
// 打印SQL模板
echo "SQL模板: " . $sql . "\n";
// 打印参数
echo "参数: " . json_encode($params) . "\n";
// 执行查询
$stmt = $pdo->prepare($sql);
$stmt->execute($params);
// 还原完整SQL（需手动替换参数占位符）
$fullSql = $sql;
foreach ($params as $key => $value) {
    $fullSql = str_replace($key, is_string($value) ? "'{$value}'" : $value, $fullSql);
}
echo "完整SQL: " . $fullSql . "\n";
?>

注意事项：

此方法对于命名参数（如status）效果良好，但对于问号占位符需要特殊处理
对于复杂的数据类型（如JSON、BLOB），可能需要额外处理
生产环境中应避免直接输出SQL,可考虑记录到日志文件

（2）使用PDOStatement的`debugDumpParams()`方法

该方法会打印预处理语句的参数信息,但不直接输出完整SQL，适合调试参数绑定：

$stmt = $pdo->prepare($sql);
$stmt->debugDumpParams(); // 输出参数类型、占位符等信息
$stmt->execute($params);

（3）创建自定义PDO类记录SQL

通过继承PDO类并重写相关方法,可以自动记录所有执行的SQL语句：

class LoggingPDO extends PDO {
    private $queries = [];
    public function __construct($dsn, $username = null, $password = null, $options = null) {
        parent::__construct($dsn, $username, $password, $options);
        $this->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
    }
    public function prepare($statement, $driver_options = []) {
        $stmt = parent::prepare($statement, $driver_options);
        return new LoggingPDOStatement($stmt, $this->queries);
    }
    public function getQueries() {
        return $this->queries;
    }
}
class LoggingPDOStatement {
    private $stmt;
    private $queries;
    public function __construct($stmt, &$queries) {
        $this->stmt = $stmt;
        $this->queries = &$queries;
    }
    public function execute($input_parameters = null) {
        $sql = $this->stmt->queryString;
        $start = microtime(true);
        $result = $this->stmt->execute($input_parameters);
        $time = (microtime(true) - $start) * 1000;
        // 记录SQL和执行时间
        $this->queries[] = [
            'sql' => $sql,
            'params' => $input_parameters,
            'time' => $time
        ];
        return $result;
    }
    public function __call($name, $args) {
        return call_user_func_array([$this->stmt, $name], $args);
    }
}
// 使用示例
$pdo = new LoggingPDO('mysql:host=localhost;dbname=test', 'username', 'password');
$stmt = $pdo->prepare("SELECT * FROM users WHERE id = ?");
$stmt->execute([1]);
$queries = $pdo->getQueries();
print_r($queries);

使用MySQLi扩展

MySQLi是MySQL官方推荐的PHP扩展,支持面向过程和面向对象两种风格。

（1）面向对象方式：`mysqli::$info`与`mysqli::query()`结合

通过query()执行SQL后，可通过mysqli::$info获取部分信息，但无法直接打印完整SQL，需手动拼接：

<?php
$mysqli = new mysqli('localhost', 'username', 'password', 'test');
if ($mysqli->connect_errno) {
    die("连接失败: " . $mysqli->connect_error);
}
$sql = "SELECT * FROM users WHERE status = 1 AND created_at > '2023-01-01'";
echo "完整SQL: " . $sql . "\n";
$result = $mysqli->query($sql);
while ($row = $result->fetch_assoc()) {
    // 处理结果
}
$result->free();
$mysqli->close();
?>

（2）使用`mysqli_debug()`函数（仅适用于MySQL）

该函数可启用MySQL的调试日志,记录SQL到文件（需配置mysqld的debug参数），但属于底层调试，生产环境慎用：

mysqli_debug("d:t:o,/tmp/client.trace"); // 记录调试信息到/tmp/client.trace

（3）创建MySQLi查询日志类

类似于PDO的自定义类,可以创建一个MySQLi查询日志类：

class LoggingMySQLi extends MySQLi {
    private $queries = [];
    public function query($query, $resultmode = MYSQLI_STORE_RESULT) {
        $start = microtime(true);
        $result = parent::query($query, $resultmode);
        $time = (microtime(true) - $start) * 1000;
        // 记录SQL和执行时间
        $this->queries[] = [
            'sql' => $query,
            'time' => $time
        ];
        return $result;
    }
    public function getQueries() {
        return $this->queries;
    }
}
// 使用示例
$mysqli = new LoggingMySQLi('localhost', 'username', 'password', 'test');
if ($mysqli->connect_errno) {
    die("连接失败: " . $mysqli->connect_error);
}
$result = $mysqli->query("SELECT * FROM users WHERE id = 1");
$queries = $mysqli->getQueries();
print_r($queries);