Разработка классов-помощников для MySQL в PHP

Как реализовать единый доступ к базе данных через синглтон?

Синглтон гарантирует, что в приложении существует только один экземпляр класса Database. Это удобно для небольших проектов, где не требуется несколько соединений.

class DatabaseSingleton {
    private static ?self $instance = null;
    private PDO $pdo;

    private function __construct(array $config) {
        // аналогично Database
    }

    public static function getInstance(array $config = []): self {
        if (self::$instance === null) {
            self::$instance = new self($config);
        }
        return self::$instance;
    }

    // методы query, fetchAll и т.д. такие же
}
  

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

$db = DatabaseSingleton::getInstance($config);
$users = $db->fetchAll('SELECT * FROM users');
  

Как обернуть mysqli в класс?

Для проектов, где PDO недоступен (устаревшие версии PHP), можно создать класс на основе mysqli. Реализация требует внимания к подготовленным выражениям и обработке ошибок.

class MySQLiWrapper {
    private mysqli $mysqli;

    public function __construct(array $config) {
        $this->mysqli = new mysqli($config['host'], $config['user'], $config['pass'], $config['dbname']);
        if ($this->mysqli->connect_errno) {
            throw new RuntimeException('Ошибка подключения: ' . $this->mysqli->connect_error);
        }
        $this->mysqli->set_charset('utf8mb4');
    }

    public function query(string $sql, array $params = []): mysqli_stmt {
        $stmt = $this->mysqli->prepare($sql);
        if ($stmt === false) {
            throw new RuntimeException('Ошибка подготовки: ' . $this->mysqli->error);
        }
        if (!empty($params)) {
            $types = str_repeat('s', count($params)); // упрощенно: все строки
            $stmt->bind_param($types, ...$params);
        }
        $stmt->execute();
        return $stmt;
    }

    public function fetchAll(string $sql, array $params = []): array {
        $stmt = $this->query($sql, $params);
        $result = $stmt->get_result();
        return $result->fetch_all(MYSQLI_ASSOC);
    }

    // остальные методы аналогично
}
  

Недостаток: связывание параметров требует указания типов, что усложняет универсальность. При передаче большого количества параметров можно использовать отражение для определения типов.

Как применить паттерн Репозиторий для отделения логики запросов?

Репозиторий абстрагирует работу с конкретной таблицей, предоставляя методы, соответствующие предметной области. Класс Database используется внутри репозитория как низкоуровневое API.

class UserRepository {
    private Database $db;

    public function __construct(Database $db) {
        $this->db = $db;
    }

    public function findById(int $id): ?array {
        return $this->db->fetchOne('SELECT * FROM users WHERE id = ?', [$id]);
    }

    public function findActive(): array {
        return $this->db->fetchAll('SELECT * FROM users WHERE status = ?', ['active']);
    }

    public function save(array $user): int {
        if (isset($user['id'])) {
            $this->db->update('users', $user, 'id = ?', [$user['id']]);
            return $user['id'];
        } else {
            return $this->db->insert('users', $user);
        }
    }

    public function remove(int $id): void {
        $this->db->delete('users', 'id = ?', [$id]);
    }
}
  

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

$db = new Database($config);
$userRepo = new UserRepository($db);
$user = $userRepo->findById(42);
$userRepo->save(['name' => 'Новый пользователь', 'age' => 30]);