1.99.0

- v 2.0 Release candidate
- PHP8 version
- Changed class names
- Implements PDO

Author: Karel Wintersky

README.md

@@ -0,0 +1,52 @@
+# Как использовать
+
+```php
+require_once __DIR__ . '/vendor/autoload.php';
+
+$config = new \Arris\Database\Config();
+
+$config->setUsername('wombat')
+    ->setPassword('wombatsql')
+    ->setDatabase('47news')
+    ->setSlowQueryThreshold(15);
+
+$pdo = $config->connect();
+
+// ИЛИ
+
+$pdo = new \Arris\Database\Connector($config);
+
+$sth = $pdo->prepare("SELECT COUNT(*) FROM articles");
+$sth->execute();
+var_dump($sth->fetchColumn());
+
+// или
+
+$sth = $pdo->query("SELECT COUNT(*) FROM articles");
+var_dump($sth->fetchColumn());
+
+// debug
+var_dump($pdo->stats()->getSlowQueries());
+
+var_dump($pdo->stats()->getLastQuery());
+```
+
+# Опции
+
+Как установить, например, `PDO::ATTR_EMULATE_PREPARES`?
+
+```php
+$config = new \Arris\Database\Config();
+$config->option(PDO::ATTR_EMULATE_PREPARES, true);
+```
+
+# Статистика
+
+- getQueryCount - количество простых запросов (query)
+- getPreparedQueryCount - количество подготовленных запросов (prepare, execute)
+- getTotalQueryCount - количество всего запросов (подготовленные и простые)
+- getTotalQueryTime - время, потраченное всеми запросами
+- getQueries - список запросов
+- getSlowQueries - список медленных запросов
+- getLastQuery - статистика по последнему запросу
+- reset - обнуление статистики

composer.json

@@ -1,6 +1,6 @@
 {
     "name": "karelwintersky/arris.database",
-    "description": "Arris µFramework database wrapper",
+    "description": "Arris µFramework database lazy connector",
     "type": "library",
     "license": "MIT",
     "authors": [
@@ -15,23 +15,13 @@
         "platform-check": false
     },
     "require": {
-        "php": ">=7.4 | 8.*",
+        "php": "^8.2",
         "ext-pdo": "*",
         "psr/log": "*"
     },
-    "require-dev": {
-        "predis/predis": "^2.0",
-        "vlucas/phpdotenv": "^3.3",
-        "symfony/var-dumper": "^5.4",
-        "php-sage/sage": "^1.3",
-        "phpunit/phpunit": "^4.8 || ^5.7 || ^6.5",
-        "php-coveralls/php-coveralls": "^1.1",
-        "rector/rector": "^1.1"
-    },
     "suggest": {
         "karelwintersky/arris.entity": "Arris µFramework: Entity Types",
-        "karelwintersky/arris.helpers": "Arris µFramework: helpers",
-        "ajur-media/fluentpdo": "^1"
+        "karelwintersky/arris.helpers": "Arris µFramework: helpers"
     },
     "autoload": {
         "psr-4": {

interfaces/Database/ConfigInterface.php

@@ -0,0 +1,35 @@
+<?php
+
+namespace Arris\Database;
+
+use Psr\Log\LoggerInterface;
+
+interface ConfigInterface
+{
+    public function __construct(array $connection_config = [], ?LoggerInterface $logger = null);
+
+    public function setDriver(?string $driver):self;
+    public function setHost(string $host = 'localhost'):self;
+    public function setPort(mixed $port): self;
+
+    public function setUsername(?string $username):self;
+    public function setPassword(?string $password):self;
+    public function setDatabase(?string $database):self;
+
+    public function setCredentials(?string $username, ?string $password): self;
+
+    public function setCharset(?string $charset): self;
+    public function setCharsetCollation(?string $charset_collation):self;
+
+    public function option(int $option, mixed $value): self;
+    public function driverOption(int $option, mixed $value): self;
+
+    public function getDSN(): string;
+    public function getUsername(): ?string;
+    public function getPassword(): ?string;
+    public function getOptions(): array;
+
+    public function connect();
+
+    public function setSlowQueryThreshold(mixed $value, bool $as_ms = true):self;
+}

interfaces/Database/ConnectorInterface.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace Arris\Database;
+
+use PDO;
+use PDOStatement;
+
+interface ConnectorInterface
+{
+    public function __construct(Config $config);
+
+    public function prepare(string $query, array $options = []): PDOStatement|false;
+    public function query($query, $fetchMode = PDO::ATTR_DEFAULT_FETCH_MODE, ...$fetchModeArgs): PDOStatement|false;
+    public function exec(string $statement): int|false;
+
+    public function lastInsertId(?string $name = null): string|false;
+
+    public function beginTransaction(): bool;
+    public function inTransaction(): bool;
+    public function commit(): bool;
+    public function rollBack(): bool;
+
+    public function errorCode(): ?string;
+    public function errorInfo(): array;
+
+    public function setAttribute(int $attribute, mixed $value): bool;
+    public function getAttribute(int $attribute): mixed;
+    public function quote(string $string, int $type = PDO::PARAM_STR): string|false;
+
+    public function stats():Stats;
+}