feat: add SQLite3 Config busyTimeout

Author: kenjis

app/Config/Database.php

@@ -67,6 +67,7 @@ class Database extends Config
         'failover'    => [],
         'port'        => 3306,
         'foreignKeys' => true,
+        'busyTimeout' => 1000,
     ];
 
     public function __construct()

system/Database/SQLite3/Connection.php

@@ -45,13 +45,26 @@ class Connection extends BaseConnection
      */
     protected $foreignKeys = false;
 
+    /**
+     * The milliseconds to sleep
+     *
+     * @var int|null milliseconds
+     *
+     * @see https://www.php.net/manual/en/sqlite3.busytimeout
+     */
+    protected $busyTimeout;
+
     public function initialize()
     {
         parent::initialize();
 
         if ($this->foreignKeys) {
             $this->enableForeignKeyChecks();
         }
+
+        if (is_int($this->busyTimeout)) {
+            $this->simpleQuery('PRAGMA busy_timeout=' . $this->busyTimeout);
+        }
     }
 
     /**

user_guide_src/source/database/configuration.rst

@@ -150,6 +150,7 @@ Explanation of Values:
                 .. important:: SQLite3 Foreign Key constraint is disabled by default.
                     See `SQLite documentation <https://www.sqlite.org/pragma.html#pragma_foreign_keys>`_.
                     To enforce Foreign Key constraint, set this config item to true.
+**busyTimeout** milliseconds (int) - Sleeps for a specified amount of time when a table is locked (``SQLite3`` only).
 =============== ===========================================================================================================
 
 .. note:: Depending on what database platform you are using (MySQL, PostgreSQL,