20250805-1

help/class_desc/enums/DBDriver.md

@@ -0,0 +1,61 @@
+# Перечисление `DBDriver`
+
+Перечисление представляет собой набор констант, определяющих типы драйверов баз данных, поддерживаемых системой.
+Используется совместно с библиотекой PHP PDO для идентификации различных типов СУБД.
+
+## Основная информация
+
+- **Автор**: Александр Бабаев
+- **Версия**: 1.0
+- **Дата начала поддержки**: с версии 1.0
+
+## Пространство имен и зависимости
+
+```php
+namespace goodboyalex\php_db_components_pack\enums;
+
+use goodboyalex\php_components_pack\traits\EnumExtensionsTrait;
+```
+
+## Возможные значения перечисления
+
+|  Константа   | Значение | Описание              |
+|:------------:|:--------:|-----------------------|
+|   `MySQL`    |   `0`    | Драйвер MySQL         |
+|   `MSSQL`    |   `1`    | Драйвер MS SQL Server |
+| `PostgreSQL` |   `2`    | Драйвер PostgreSQL    |
+|  `OracleDB`  |   `3`    | Драйвер Oracle        |
+|   `SQLite`   |   `4`    | Драйвер SQLite        |
+
+## Особенности реализации
+
+Используется trait `EnumExtensionsTrait`, предоставляющий дополнительные методы для работы с перечислениями, такие как
+преобразование значений в целые числа и обратно.
+
+## Использование
+
+Примеры использования перечисления:
+
+```php
+use goodboyalex\php_db_components_pack\enums\DBDriver;
+
+// Получение значения по имени
+$dbType = DBDriver::MySQL;
+
+// Проверка типа драйвера
+if ($dbType === DBDriver::MySQL)
+    echo "Это MySQL";
+```
+
+## Совместимость
+
+Перечисление совместимо с современными версиями PHP, начиная с версии 8.1, поддерживающей нативные перечисления (
+`enum`). Если используется более ранняя версия PHP, возможно потребуется альтернативная реализация на основе классов или
+сторонних пакетов.
+
+## Вывод
+
+Этот класс является частью библиотеки `goodboyalex/php_db_components_pack` и предназначен для унификации работы с
+различными системами управления базами данных посредством стандартного интерфейса PDO.
+
+[На гравную](../../index.md)