Как на PHP реализовать «ленивое» подключение к базе данных (Singleton), чтобы коннект создавался только в момент первого запроса?

Паттерн Singleton с «ленивой» инициализацией (Lazy Initialization) — один из самых распространённых способов управления подключением к базе данных в PHP. Суть подхода: объект соединения создаётся не при старте приложения, а только в тот момент, когда он действительно понадобился — при первом обращении к базе данных.

## Почему это важно?

Если создавать подключение к БД при каждом запросе или в конструкторе класса без необходимости, это приводит к лишним затратам ресурсов: открытие TCP-соединения, аутентификация, выделение памяти. В сценариях, где часть запросов не обращается к базе вообще, это особенно расточительно.

## Базовая реализация на PHP с PDO

php
class Database
{
private static ?Database $instance = null;
private ?PDO $connection = null;

private string $dsn;
private string $user;
private string $password;

// Приватный конструктор — запрещает создание через new
private function __construct(string $dsn, string $user, string $password)
{
$this->dsn = $dsn;
$this->user = $user;
$this->password = $password;
}

// Запрещаем клонирование
private function __clone() {}

// Запрещаем десериализацию
public function __wakeup()
{
throw new Exception(‘Cannot unserialize singleton’);
}

// Получение единственного экземпляра класса
public static function getInstance(string $dsn = », string $user = », string $password = »): self
{
if (self::$instance === null) {
self::$instance = new self($dsn, $user, $password);
}
return self::$instance;
}

// «Ленивое» подключение: коннект создаётся только здесь
public function getConnection(): PDO
{
if ($this->connection === null) {
$this->connection = new PDO(
$this->dsn,
$this->user,
$this->password,
[
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
PDO::ATTR_EMULATE_PREPARES => false,
]
);
}
return $this->connection;
}
}

## Использование

php
$db = Database::getInstance(‘mysql:host=localhost;dbname=mydb;charset=utf8mb4’, ‘root’, ‘secret’);

// Подключение к БД произойдёт только здесь, при первом вызове getConnection()
$pdo = $db->getConnection();
$stmt = $pdo->query(‘SELECT * FROM users’);
$users = $stmt->fetchAll();

## Ключевые моменты реализации

1. **Приватный конструктор** — исключает создание объекта через `new Database()`.
2. **Статическое свойство `$instance`** — хранит единственный экземпляр класса.
3. **Свойство `$connection`** инициализируется `null` и создаётся только в методе `getConnection()` — это и есть «ленивость».
4. **Запрет клонирования и десериализации** — защита от обхода Singleton через `clone` и `unserialize`.

## Рекомендации

— Для больших приложений рассмотрите Dependency Injection Container (DIC) вместо «голого» Singleton — это улучшает тестируемость.
— В многопоточных средах (например, Swoole) статические свойства могут вести себя иначе — учитывайте это.
— Всегда передавайте параметры подключения через переменные окружения, а не хардкодьте их в коде.

Такой подход позволяет экономить ресурсы сервера и при этом гарантировать единственное соединение с базой данных на протяжении всего жизненного цикла запроса.