| 
        php.net | support | documentation | report a bug | advanced search | search howto | statistics | random bug | login | 
  [2019-11-14 11:34 UTC] deus dot kane at claromentis dot com
 Description:
------------
Calling SQLite3::query with a resultless query returns a mostly useless result object.
Prior to PHP 7.2.24 calling SQLite3Result::numColumns on this result object would return zero, indicating that this was a query with no data to step through.
In PHP 7.2.24, calling SQLite3Result::numColumns on this result object returns 1, making it indistingishable from a result object that contains data. In addition, when calling SQLite3Result::columnName with the value 0 returns "1" (as a string).
The previous behaviour was relied on by my company when implementing an SQLite driver for our database layer. As we are issuing arbitrary queries, we always called ::query, and then used the fact that a query with no result had zero columns to avoid re-executing the query by stepping through it.
Test script:
---------------
<?php
$db = new SQLite3(":memory:");
$result = $db->query("CREATE TABLE users(id INTEGER PRIMARY KEY)");
$result = $db->query("ALTER TABLE users RENAME TO user_temp");
print($result->numColumns());
Expected result:
----------------
0 is output to the screen
Actual result:
--------------
1 is output to the screen
PatchesPull RequestsHistoryAllCommentsChangesGit/SVN commits             
             | 
    |||||||||||||||||||||||||||
            
                 
                Copyright © 2001-2025 The PHP GroupAll rights reserved.  | 
        Last updated: Tue Nov 04 03:00:01 2025 UTC | 
This behavioral change is caused by upgrading our bundled libsqlite to 3.28.0, and is an upstream issue. Not sure when exactly the behavior changed (must have been after 3.25.1), and whether this would be regarded as bug (the docs are not particularly clear on this). Anyway, pure C reproducer: #include <string.h> #include <stdio.h> #include <assert.h> #include <sqlite3.h> #define SQL_CREATE "CREATE TABLE users(id INTEGER PRIMARY KEY)" #define SQL_ALTER "ALTER TABLE users RENAME TO user_temp" int main() { sqlite3 *db; sqlite3_stmt *stmt; int rc; rc = sqlite3_open_v2(":memory:", &db, SQLITE_OPEN_READWRITE | SQLITE_OPEN_CREATE, NULL); assert(rc == SQLITE_OK); rc = sqlite3_prepare_v2(db, SQL_CREATE, strlen(SQL_CREATE), &stmt, NULL); assert(rc == SQLITE_OK); rc = sqlite3_step(stmt); assert(rc == SQLITE_DONE); printf("%d\n", sqlite3_column_count(stmt)); rc = sqlite3_finalize(stmt); assert(rc == SQLITE_OK); rc = sqlite3_prepare_v2(db, SQL_ALTER, strlen(SQL_ALTER), &stmt, NULL); assert(rc == SQLITE_OK); rc = sqlite3_step(stmt); assert(rc == SQLITE_DONE); printf("%d\n", sqlite3_column_count(stmt)); rc = sqlite3_finalize(stmt); assert(rc == SQLITE_OK); rc = sqlite3_close_v2(db); assert(rc == SQLITE_OK); return 0; }