Modernize code

src/Adapter/BaseAdapter.php

@@ -1,3 +1,3 @@
 <?php
 
 namespace ipl\Sql\Adapter;
@@ -21,21 +21,21 @@
      *
      * @var array
      */
-    protected $quoteCharacter = ['"', '"'];
+    protected array $quoteCharacter = ['"', '"'];
 
     /** @var string Character to use for escaping quote characters */
-    protected $escapeCharacter = '\\"';
+    protected string $escapeCharacter = '\\"';
 
     /** @var array Default PDO connect options */
-    protected $options = [
+    protected array $options = [
         PDO::ATTR_CASE => PDO::CASE_NATURAL,
         PDO::ATTR_EMULATE_PREPARES => false,
         PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
         PDO::ATTR_ORACLE_NULLS => PDO::NULL_NATURAL,
         PDO::ATTR_STRINGIFY_FETCHES => false
     ];
 
-    public function getDsn(Config $config)
+    public function getDsn(Config $config): string
     {
         $dsn = "{$config->db}:";
 
@@ -50,21 +50,21 @@
         return $dsn . implode(';', $parts);
     }
 
-    public function getOptions(Config $config)
+    public function getOptions(Config $config): array
     {
         if (is_array($config->options)) {
             return $config->options + $this->options;
         }
 
         return $this->options;
     }
 
-    public function setClientTimezone(Connection $db)
+    public function setClientTimezone(Connection $db): static
     {
         return $this;
     }
 
-    public function quoteIdentifier($identifiers)
+    public function quoteIdentifier(array|string $identifiers): string
     {
         if (is_string($identifiers)) {
             $identifiers = explode('.', $identifiers);
@@ -75,27 +75,27 @@
                 continue;
             }
 
             $identifiers[$i] = $this->quoteCharacter[0]
                 . str_replace($this->quoteCharacter[0], $this->escapeCharacter, $identifier)
                 . $this->quoteCharacter[1];
         }
 
         return implode('.', $identifiers);
     }
 
-    public function registerQueryBuilderCallbacks(QueryBuilder $queryBuilder)
+    public function registerQueryBuilderCallbacks(QueryBuilder $queryBuilder): static
     {
         $queryBuilder->on(QueryBuilder::ON_ASSEMBLE_SELECT, function (Select $select): void {
             if ($select->hasOrderBy()) {
                 foreach ($select->getOrderBy() as list($_, $direction)) {
                     switch (strtolower($direction ?? '')) {
                         case '':
                         case 'asc':
                         case 'desc':
                             break;
                         default:
                             throw new UnexpectedValueException(
                                 sprintf('Invalid direction "%s" in ORDER BY', $direction)
                             );
                     }
                 }
@@ -105,7 +105,7 @@
         return $this;
     }
 
-    protected function getTimezoneOffset()
+    protected function getTimezoneOffset(): string
     {
         $tz = new DateTimeZone(date_default_timezone_get());
         $offset = $tz->getOffset(new DateTime());

src/Adapter/Mssql.php

@@ -10,11 +10,11 @@
 
 class Mssql extends BaseAdapter
 {
-    protected $quoteCharacter = ['[', ']'];
+    protected array $quoteCharacter = ['[', ']'];
 
-    protected $escapeCharacter = '[[]';
+    protected string $escapeCharacter = '[[]';
 
-    public function getDsn(Config $config)
+    public function getDsn(Config $config): string
     {
         $drivers = array_intersect(['sqlsrv', 'dblib', 'mssql', 'sybase'], PDO::getAvailableDrivers());
 
@@ -62,7 +62,7 @@ public function getDsn(Config $config)
         return $dsn;
     }
 
-    public function registerQueryBuilderCallbacks(QueryBuilder $queryBuilder)
+    public function registerQueryBuilderCallbacks(QueryBuilder $queryBuilder): static
     {
         parent::registerQueryBuilderCallbacks($queryBuilder);
 

src/Adapter/Mysql.php

@@ -4,22 +4,21 @@
 
 use ipl\Sql\Config;
 use ipl\Sql\Connection;
-use PDO;
 
 class Mysql extends BaseAdapter
 {
-    protected $quoteCharacter = ['`', '`'];
+    protected array $quoteCharacter = ['`', '`'];
 
-    protected $escapeCharacter = '``';
+    protected string $escapeCharacter = '``';
 
-    public function setClientTimezone(Connection $db)
+    public function setClientTimezone(Connection $db): static
     {
         $db->exec('SET time_zone = ' . $db->quote($this->getTimezoneOffset()));
 
         return $this;
     }
 
-    public function getOptions(Config $config)
+    public function getOptions(Config $config): array
     {
         $options = parent::getOptions($config);
         // In PHP 8.5+, driver-specific constants of the PDO class are deprecated,
@@ -32,11 +31,11 @@
 
         if (! empty($config->useSsl)) {
             if (! empty($config->sslKey)) {
                 $options[constant($mysqlConstantPrefix . 'SSL_KEY')] = $config->sslKey;
             }
 
             if (! empty($config->sslCert)) {
                 $options[constant($mysqlConstantPrefix . 'SSL_CERT')] = $config->sslCert;
             }
 
             if (! empty($config->sslCa)) {

src/Adapter/Oracle.php

@@ -7,7 +7,7 @@
 
 class Oracle extends BaseAdapter
 {
-    public function getDsn(Config $config)
+    public function getDsn(Config $config): string
     {
         $dsn = 'oci:dbname=';
 
@@ -30,7 +30,7 @@ public function getDsn(Config $config)
         return $dsn;
     }
 
-    public function setClientTimezone(Connection $db)
+    public function setClientTimezone(Connection $db): static
     {
         $db->prepexec('ALTER SESSION SET TIME_ZONE = ?', [$this->getTimezoneOffset()]);
 

src/Adapter/Pgsql.php

@@ -6,9 +6,9 @@
 
 class Pgsql extends BaseAdapter
 {
-    public function setClientTimezone(Connection $db)
+    public function setClientTimezone(Connection $db): static
     {
         $db->exec(sprintf('SET TIME ZONE INTERVAL %s HOUR TO MINUTE', $db->quote($this->getTimezoneOffset())));
 
         return $this;
     }

src/Adapter/Sqlite.php

@@ -6,7 +6,7 @@
 
 class Sqlite extends BaseAdapter
 {
-    public function getDsn(Config $config)
+    public function getDsn(Config $config): string
     {
         return "sqlite:{$config->dbname}";
     }

src/CommonTableExpression.php

@@ -17,21 +17,21 @@ trait CommonTableExpression
      *
      * @var array[]
      */
-    protected $with = [];
+    protected array $with = [];
 
-    public function getWith()
+    public function getWith(): array
     {
         return $this->with;
     }
 
-    public function with(Select $query, $alias, $recursive = false)
+    public function with(Select $query, string $alias, bool $recursive = false): static
     {
         $this->with[] = [$query, $alias, $recursive];
 
         return $this;
     }
 
-    public function resetWith()
+    public function resetWith(): static
     {
         $this->with = [];
 
@@ -43,7 +43,7 @@ public function resetWith()
      *
      * Shall be called by using classes in their __clone()
      */
-    protected function cloneCte()
+    protected function cloneCte(): void
     {
         foreach ($this->with as &$cte) {
             $cte[0] = clone $cte[0];

src/CommonTableExpressionInterface.php

@@ -17,7 +17,7 @@ interface CommonTableExpressionInterface
      *
      * @return array[]
      */
-    public function getWith();
+    public function getWith(): array;
 
     /**
      * Add a CTE
@@ -28,12 +28,12 @@ public function getWith();
      *
      * @return $this
      */
-    public function with(Select $query, $alias, $recursive = false);
+    public function with(Select $query, string $alias, bool $recursive = false): static;
 
     /**
      * Reset all CTEs
      *
      * @return $this
      */
-    public function resetWith();
+    public function resetWith(): static;
 }

src/Compat/FilterProcessor.php

@@ -13,7 +13,7 @@
 
 class FilterProcessor
 {
-    public static function assembleFilter(Filter\Rule $filter, $level = 0)
+    public static function assembleFilter(Filter\Rule $filter, int $level = 0): ?array
     {
         $condition = null;
 
@@ -60,7 +60,7 @@ public static function assembleFilter(Filter\Rule $filter, $level = 0)
         return $condition;
     }
 
-    public static function assemblePredicate(Filter\Condition $filter)
+    public static function assemblePredicate(Filter\Condition $filter): array
     {
         $column = $filter->getColumn();
         $expression = $filter->getValue();

src/Config.php

@@ -2,34 +2,31 @@
 
 namespace ipl\Sql;
 
-use InvalidArgumentException;
 use ipl\Stdlib\Str;
 use OutOfRangeException;
 
-use function ipl\Stdlib\get_php_type;
-
 /**
  * SQL connection configuration
  */
 class Config
 {
-    /** @var string Type of the DBMS */
-    public $db;
+    /** @var ?string Type of the DBMS */
+    public ?string $db = null;
 
-    /** @var string Database host */
-    public $host;
+    /** @var ?string Database host */
+    public ?string $host = null;
 
-    /** @var int Database port */
-    public $port;
+    /** @var string|int|null Database port */
+    public string|int|null $port = null;
 
-    /** @var string Database name */
-    public $dbname;
+    /** @var ?string Database name */
+    public ?string $dbname = null;
 
-    /** @var string Username to use for authentication */
-    public $username;
+    /** @var ?string Username to use for authentication */
+    public ?string $username = null;
 
-    /** @var string Password to use for authentication */
-    public $password;
+    /** @var ?string Password to use for authentication */
+    public ?string $password = null;
 
     /**
      * Character set for the connection
@@ -38,7 +35,7 @@ class Config
      *
      * @var string
      */
-    public $charset;
+    public string $charset = '';
 
     /**
      * PDO connect options
@@ -48,30 +45,20 @@ class Config
      *
      * @var array
      */
-    public $options;
+    public array $options = [];
 
     /** @var array Extra settings e.g. for SQL SSL connections */
-    protected $extraSettings = [];
+    protected array $extraSettings = [];
 
     /**
      * Create a new SQL connection configuration from the given configuration key-value pairs
      *
      * Keys will be converted to camelCase, e.g. use_ssl → useSsl.
      *
      * @param iterable $config Configuration key-value pairs
-     *
-     * @throws InvalidArgumentException If $config is not iterable
      */
-    public function __construct($config)
+    public function __construct(iterable $config)
     {
-        if (! is_iterable($config)) {
-            throw new InvalidArgumentException(sprintf(
-                '%s expects parameter one to be iterable, got %s instead',
-                __METHOD__,
-                get_php_type($config)
-            ));
-        }
-
         foreach ($config as $key => $value) {
             $key = Str::camel($key);
             $this->$key = $value;