ext/sqlite3: adding busy() call.

checks if the prepared statement had been fetched but did not complete yet.

close GH-18843

Author: devnexen

NEWS

@@ -240,6 +240,10 @@ PHP                                                                        NEWS
   . Fix overall theorical overflows on zend_string buffer allocations.
     (David Carlier/nielsdos)
 
+- Sqlite:
+  . Added Sqlite3Stmt::busy to check if a statement is still being executed.
+    (David Carlier)
+
 - Standard:
   . Fixed crypt() tests on musl when using --with-external-libcrypt
     (Michael Orlitzky).

UPGRADING

@@ -393,6 +393,10 @@ PHP 8.5 UPGRADE NOTES
   . ReflectionConstant::getAttributes() was introduced.
     RFC: https://wiki.php.net/rfc/attributes-on-constants
 
+- Sqlite:
+  . Sqlite3Stmt::busy to check if a statement had been fetched
+    but not completely.
+
 - Standard:
   . Added array_first() and array_last().
     RFC: https://wiki.php.net/rfc/array_first_last

ext/sqlite3/sqlite3.c

@@ -1479,6 +1479,23 @@ PHP_METHOD(SQLite3Stmt, readOnly)
 }
 /* }}} */
 
+PHP_METHOD(SQLite3Stmt, busy)
+{
+	php_sqlite3_stmt *stmt_obj;
+	zval *object = ZEND_THIS;
+	stmt_obj = Z_SQLITE3_STMT_P(object);
+
+	ZEND_PARSE_PARAMETERS_NONE();
+
+	SQLITE3_CHECK_INITIALIZED(stmt_obj->db_obj, stmt_obj->initialised, SQLite3);
+	SQLITE3_CHECK_INITIALIZED_STMT(stmt_obj->stmt, SQLite3Stmt);
+
+	if (sqlite3_stmt_busy(stmt_obj->stmt)) {
+		RETURN_TRUE;
+	}
+    RETURN_FALSE;
+}
+
 /* bind parameters to a statement before execution */
 static int php_sqlite3_bind_params(php_sqlite3_stmt *stmt_obj) /* {{{ */
 {

ext/sqlite3/sqlite3.stub.php

@@ -272,6 +272,8 @@ public function readOnly(): bool {}
 
     /** @tentative-return-type */
     public function reset(): bool {}
+
+    public function busy(): bool {}
 }
 
 /** @not-serializable */

ext/sqlite3/sqlite3_arginfo.h

@@ -0,0 +1,24 @@
+--TEST--
+SQLite3_stmt::busy
+--EXTENSIONS--
+sqlite3
+--SKIPIF--
+<?php
+$version = SQLite3::version();
+if ($version['versionNumber'] < 3007004) die("skip");
+?>
+--FILE--
+<?php
+
+require_once(__DIR__ . '/new_db.inc');
+$db->exec('CREATE TABLE test_busy (a string);');
+$db->exec('INSERT INTO test_busy VALUES ("interleaved"), ("statements")');
+$st = $db->prepare('SELECT a FROM test_busy');
+var_dump($st->busy());
+$r = $st->execute();
+$r->fetchArray();
+var_dump($st->busy());
+?>
+--EXPECT--
+bool(false)
+bool(true)