Merge remote-tracking branch 'origin/main' into big-init

Author: ArnabChatterjee20k

src/Database/Adapter.php

@@ -1588,4 +1588,9 @@ abstract public function getSupportForTransactionRetries(): bool;
      * @return bool
      */
     abstract public function getSupportForNestedTransactions(): bool;
+
+    /**
+     * @return mixed
+     */
+    abstract public function getDriver(): mixed;
 }

src/Database/Adapter/Mongo.php

@@ -77,6 +77,15 @@ public function __construct(Client $client)
         $this->client->connect();
     }
 
+    /**
+     * Returns the current Mongo client
+     * @return mixed
+     */
+    public function getDriver(): mixed
+    {
+        return $this->client;
+    }
+
     public function setTimeout(int $milliseconds, string $event = Database::EVENT_ALL): void
     {
         if (!$this->getSupportForTimeouts()) {
@@ -2916,7 +2925,7 @@ protected function getQueryValue(string $method, mixed $value): mixed
      */
     protected function getOrder(string $order): int
     {
-        return match ($order) {
+        return match (\strtoupper($order)) {
             Database::ORDER_ASC => 1,
             Database::ORDER_DESC => -1,
             default => throw new DatabaseException('Unknown sort order:' . $order . '. Must be one of ' . Database::ORDER_ASC . ', ' . Database::ORDER_DESC),

src/Database/Adapter/Pool.php

@@ -70,6 +70,11 @@ public function delegate(string $method, array $args): mixed
         });
     }
 
+    public function getDriver(): mixed
+    {
+        return $this->delegate(__FUNCTION__, \func_get_args());
+    }
+
     public function before(string $event, string $name = '', ?callable $callback = null): static
     {
         $this->delegate(__FUNCTION__, \func_get_args());

src/Database/Adapter/SQL.php

@@ -2193,12 +2193,22 @@ protected function applyOperatorToValue(Operator $operator, mixed $value): mixed
     /**
      * Returns the current PDO object
      * @return mixed
+     * @deprecated Use getDriver() instead
      */
     protected function getPDO(): mixed
     {
         return $this->pdo;
     }
 
+    /**
+     * Returns the current PDO object
+     * @return mixed
+     */
+    public function getDriver(): mixed
+    {
+        return $this->pdo;
+    }
+
     /**
      * Get PDO Type
      *