SQLite3Stmt::getSQL

(PHP 7 >= 7.4.0, PHP 8)

SQLite3Stmt::getSQL — Get the SQL of the statement

Descripción

public SQLite3Stmt::getSQL(bool $expand = false): string|false

Retrieves the SQL of the prepared statement. If expand is false, the unmodified SQL is retrieved. If expand is true, all query parameters are replaced with their bound values, or with an SQL NULL, if not already bound.

Parámetros

expand: Whether to retrieve the expanded SQL. Passing true is only supported as of libsqlite 3.14.

Valores devueltos

Returns the SQL of the prepared statement, o false en caso de error.

Errores/Excepciones

If expand is true, but the libsqlite version is less than 3.14, an error of level E_WARNING or an Exception is issued, according to SQLite3::enableExceptions().

Ejemplos

Ejemplo #1 Inspecting the expanded SQL

<?php
$db = new SQLite3(':memory:');
$stmt = $db->prepare("SELECT :a, ?, :c");
$stmt->bindValue(':a', 'foo');
$answer = 42;
$stmt->bindParam(2, $answer);
var_dump($stmt->getSQL(true));
?>

El resultado del ejemplo sería algo similar a:

string(24) "SELECT 'foo', '42', NULL"

add a note

User Contributed Notes

There are no user contributed notes for this page.