Prepare for v1.0.1 release with join and experimental sqlite support

Author: dmarkic

CHANGELOG.md

@@ -1,18 +1,10 @@
 # Changelog
 
-## main-dev (2024-03-17)
-
-- QueryBuilder and Condition/ConditionGroup now have `fromArray()` and `toArray()` methods.
+## v1.0.1 (2024-04-21)
 
-## main-dev (2024-03-25)
-
-- Offical docs page: https://blrf.net/dbal/
-- Full coverage
-- Condtion/ConditionBuilder support for more operators (lg, lge, like, isNull, ...)
-
-## main-dev (2024-04-04)
-
-- PHPStan on max
+- QueryBuilder::join() added
+- sqlite driver added EXPERIMENTAL (rather old version, not production ready)
+- Connection::quit() method added
 
 ## v1.0.0 (2024-04-10)
 
@@ -23,3 +15,17 @@
 - Update QueryBuilderInterface
 - Fix Result $rows param
 - Test QueryBuilder::select() with SelectExpression
+
+## main-dev (2024-04-04)
+
+- PHPStan on max
+
+## main-dev (2024-03-25)
+
+- Offical docs page: https://blrf.net/dbal/
+- Full coverage
+- Condtion/ConditionBuilder support for more operators (lg, lge, like, isNull, ...)
+
+## main-dev (2024-03-17)
+
+- QueryBuilder and Condition/ConditionGroup now have `fromArray()` and `toArray()` methods.

README.md

@@ -120,5 +120,4 @@ MIT, see [LICENSE file](LICENSE).
 
 - Write more examples
 - Write having
-- Write joins
 - Schema manager

examples/select.php

@@ -18,9 +18,11 @@ function (Blrf\Dbal\Connection $db) {
                     $cb->eq('title')
                 )
             )
+            ->orderBy('publication_date', 'DESC')
             ->setParameters(['9789998691568', 1, 'Moby Dick'])
             ->limit(3);
-        // sql: SELECT * FROM book WHERE ((isbn13 = ? AND language_id = ?) OR title = ?) LIMIT 3
+        // sql: SELECT * FROM book WHERE ((isbn13 = ? AND language_id = ?) OR title = ?)
+        //      ORDER BY publication_date DESC LIMIT 3
         return $qb->execute();
     }
 )->then(

examples/selectJoin.php

@@ -0,0 +1,31 @@
+<?php
+
+require __DIR__ . '/../vendor/autoload.php';
+$config  = new Blrf\Dbal\Config('mysql://user:pass@localhost/bookstore');
+
+$config->create()->then(
+    function (Blrf\Dbal\Connection $db) {
+        // start query builder
+        $qb = $db->query()
+            ->select('*')
+            ->from('customer_address', 'address')
+            ->join('address_status', 'address.status_id = status.status_id', 'status')
+            ->where(
+                fn(Blrf\Dbal\Query\ConditionBuilder $cb) => $cb->and(
+                    $cb->eq('address.customer_id'),
+                    $cb->like('status.address_status')
+                )
+            )
+            ->setParameters([3, 'Inac%'])
+            ->limit(4);
+        echo "sql: " . $qb->getSql() . "\n";
+        // sql: SELECT * FROM customer_address AS address
+        //      INNER JOIN address_status AS status ON address.status_id = status.status_id
+        //      WHERE (address.customer_id = ? AND status.address_status LIKE ?) LIMIT 4
+        return $qb->execute();
+    }
+)->then(
+    function (Blrf\Dbal\Result $result) {
+        print_r($result->rows);
+    }
+);

phpstan.neon.dist

@@ -5,6 +5,11 @@ parameters:
         # Condition::fromArray() will return Condition or ConditionGroup based on $data keys
         # don't know how to tell that to phpstan
         - tests/Query/ConditionTest.php
+        #
+        # SQlite driver requires additional extensions and SQLite driver
+        # is rather experimental. So we'll skip it for now.
+        #
+        - src/Driver/Sqlite
 
     paths:
         - src/

src/Config.php

@@ -32,7 +32,8 @@ class Config implements Stringable
      * @var array<string,string>
      */
     protected static array $driverMap = [
-        'mysql' => \Blrf\Dbal\Driver\Mysql\Driver::class
+        'mysql'     => \Blrf\Dbal\Driver\Mysql\Driver::class,
+        'sqlite'    => \Blrf\Dbal\Driver\Sqlite\Driver::class
     ];
     /**
      * Dbal driver
@@ -219,7 +220,7 @@ public function createDriver(): Driver
     {
         $driver = $this->driver;
         if (!class_exists($driver)) {
-            $class = self::$driverMap[$driver];
+            $class = self::$driverMap[$driver] ?? null;
             if ($class === null) {
                 throw new RuntimeException('No such driver: ' . $driver);
             }

src/Connection.php

@@ -42,6 +42,13 @@ public function execute(string $sql, array $params = []): PromiseInterface;
      */
     public function stream(string $sql, array $params = []): ResultStream;
 
+    /**
+     * Quit (soft-close) the connection
+     *
+     * @return PromiseInterface<void>
+     */
+    public function quit(): PromiseInterface;
+
     /**
      * Get native connection
      */

src/Driver/Connection.php

@@ -53,6 +53,13 @@ abstract public function execute(string $sql, array $params = []): PromiseInterf
      */
     abstract public function stream(string $sql, array $params = []): ResultStream;
 
+    /**
+     * Quit (soft-close) the connection
+     *
+     * @return PromiseInterface<void>
+     */
+    abstract public function quit(): PromiseInterface;
+
     /**
      * Set underlying native connection
      */

src/Driver/Mysql/Connection.php

@@ -57,4 +57,10 @@ public function stream(string $sql, array $params = []): ResultStream
         // @phpstan-ignore-next-line
         return new ResultStream($this->getNativeConnection()->queryStream($sql, $params));
     }
+
+    public function quit(): PromiseInterface
+    {
+        // @phpstan-ignore-next-line
+        return $this->getNativeConnection()->quit();
+    }
 }

src/Driver/Sqlite/Connection.php

@@ -0,0 +1,70 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Blrf\Dbal\Driver\Sqlite;
+
+use Blrf\Dbal\Config;
+use Blrf\Dbal\Result;
+use Blrf\Dbal\ResultStream;
+use Blrf\Dbal\Driver\Connection as DriverConnection;
+use Clue\React\SQLite\Factory;
+use Clue\React\SQLite\DatabaseInterface;
+use Clue\React\SQLite\Result as SqliteResult;
+use React\Promise\PromiseInterface;
+
+use function React\Promise\resolve;
+
+/**
+ * React-Php Sqlite driver
+ *
+ * @see https://github.com/clue/reactphp-sqlite
+ */
+class Connection extends DriverConnection
+{
+    public function connect(): PromiseInterface
+    {
+        $factory = new Factory();
+        return $factory->open('/' . $this->config->getDb(), SQLITE3_OPEN_READWRITE)->then(
+            function (DatabaseInterface $db) {
+                return $this->setNativeConnection($db);
+            }
+        );
+    }
+
+    public function query(): QueryBuilder
+    {
+        return new QueryBuilder($this);
+    }
+
+    /**
+     * Execute sql query
+     *
+     * @param array<int, string> $params
+     * @return PromiseInterface<Result>
+     */
+    public function execute(string $sql, array $params = []): PromiseInterface
+    {
+        // @phpstan-ignore-next-line
+        return $this->getNativeConnection()->query($sql, $params)->then(
+            function (SqliteResult $res) {
+                return new Result(
+                    $res->rows ?? [],
+                    $res->insertId,
+                    $res->changed ?? 0,
+                    0
+                );
+            }
+        );
+    }
+
+    public function stream(string $sql, array $params = []): ResultStream
+    {
+        throw new \Exception('Stream not yet supported on sqlite');
+    }
+
+    public function quit(): PromiseInterface
+    {
+        return $this->getNativeConnection()->quit();
+    }
+}