Конфигурация

Всё, что описывает соединение и управляет им: базовые классы конфигурации и их значения по умолчанию, инлайновые конструкторы Call, методы жизненного цикла, общие для всех конфигов, реестр ConnectionPool и вспомогательные типы-значения CDOStatement и CDOBind.

Иерархия классов конфигурации

DbConfigInterface
└── BaseDbConfig (абстрактный) — жизненный цикл, проверки здоровья, логгер
  ├── PgDbConfig      (абстрактный) — умолчания PostgreSQL + schema/charset
  ├── MySqlDbConfig   (абстрактный) — умолчания MySQL/MariaDB + charset
  ├── DbConfig        (абстрактный) — явный $driver, без умолчаний
  └── Config\Call\
      ├── PgDbCall     — инлайновый PostgreSQL (аргументы конструктора)
      ├── MySqlDbCall  — инлайновый MySQL/MariaDB (аргументы конструктора)
      └── DbCall       — инлайновый общий (драйвер в конструкторе)

Наследуйте абстрактную базу и задавайте учётные данные в setUp(); используйте класс Call для разового соединения без определения подкласса.

PgDbConfig

Наследуйте для PostgreSQL. Свойства и умолчания:

getDriver() возвращает 'pgsql'. charset, если задан, добавляет к DSN options='--client_encoding=…'. schema возвращается методом getSchema() для вышестоящих слоёв, задающих search_path — CDO не применяет его автоматически.

MySqlDbConfig

Наследуйте для MySQL или MariaDB:

getDriver() возвращает 'mysql'; MariaDB определяется во время выполнения (см. Определение драйвера). charset добавляет к DSN charset=….

DbConfig

База, независимая от драйвера — вы сами задаёте $this->driver в setUp(), вместе с host, port, database, username, password. Умолчаний нет. Используйте её, когда нужен драйвер без выделенной базы.

Инлайновые классы Call

Конкретные конфиги, принимающие всё в конструкторе:

use Flytachi\Winter\Cdo\Config\Call\PgDbCall;
use Flytachi\Winter\Cdo\Config\Call\MySqlDbCall;
use Flytachi\Winter\Cdo\Config\Call\DbCall;

$pg = new PgDbCall(host: '127.0.0.1', database: 'myapp', username: 'postgres', password: 'secret');
$my = new MySqlDbCall(host: '127.0.0.1', database: 'myapp', username: 'root', password: 'secret', charset: 'utf8mb4');
$any = new DbCall(driver: 'mysql', host: '127.0.0.1', port: 3306, database: 'myapp', username: 'root', password: 'secret');

$cdo = $pg->connection();

• PgDbCall / MySqlDbCall — все аргументы необязательны, откатываются к тем же умолчаниям, что и их абстрактные аналоги.
• DbCall — все аргументы обязательны, включая driver.

Жизненный цикл соединения

Каждый конфиг (через BaseDbConfig) предоставляет:

Постоянные соединения выключены по умолчанию; задайте protected bool $isPersistent = true в подклассе, чтобы включить PDO::ATTR_PERSISTENT. Режим отладки (PDO::ERRMODE_EXCEPTION) включается, когда переменная окружения DEBUG истинна.

ConnectionPool

Реестр уровня процесса, создающий каждый конфиг один раз и возвращающий готовое соединение.

$cdo = ConnectionPool::db(AppDb::class);           // самое частое
$config = ConnectionPool::getConfigDb(AppDb::class); // для ping / reconnect

Аргумент $logger у getConfigDb() применяется только при первом вызове для данного класса; последующие вызовы возвращают закешированный экземпляр и игнорируют его.

CDOStatement

Типозависимая обёртка над PDOStatement, используемая внутри каждым методом DML. Её ключевой метод, bindTypedValue($param, $value), выбирает PDO-тип из gettype($value). Полная карта типов — в Привязке параметров.

CDOBind

Неизменяемая пара «имя + значение» — единица, которую Qb порождает для каждого скаляра. Постройте её вручную, чтобы дать плейсхолдеру имя или разделить его между условиями.

use Flytachi\Winter\Cdo\CDOBind;

$bind = new CDOBind('user_id', 42);
$bind->getName();  // ':user_id'  (ведущее ':' добавляется, если опущено)
$bind->getValue(); // 42

Связанное

• Установка — первый конфиг, шаг за шагом
• Логирование и диагностика — логгер и проверки здоровья
• Привязка параметров — как CDOStatement типизирует значения
• Построение условий — CDOBind в Qb