Deploymentcenter/src/Core/Db.php

<?php

declare(strict_types=1);

namespace Deploymentcenter\Core;

use PDO;
use PDOException;
use RuntimeException;

/**
 * Zentrale PDO-Verbindung.
 *
 * Die Session-Zeitzone wird fest auf UTC gesetzt. Damit liefert NOW() echte
 * UTC-Werte - passend zu den Spalten, die auf _utc enden - und alle
 * Zeitvergleiche (Watchdog-Evaluator, Lease-Ablauf) rechnen auf derselben
 * Basis. Die Darstellung im WebUI erfolgt in der App-Zeitzone.
 */
final class Db
{
    private static ?PDO $instance = null;

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

        if ($config === []) {
            $dbConfig = Config::db();
        } elseif (isset($config['db']) && is_array($config['db'])) {
            $dbConfig = $config['db'];
        } else {
            $dbConfig = $config;
        }

        foreach (['host', 'dbname', 'username'] as $required) {
            if (!isset($dbConfig[$required]) || $dbConfig[$required] === '') {
                throw new RuntimeException('Datenbank-Konfiguration unvollstaendig: ' . $required . ' fehlt.');
            }
        }

        $dsn = sprintf(
            'mysql:host=%s;dbname=%s;charset=%s',
            $dbConfig['host'],
            $dbConfig['dbname'],
            $dbConfig['charset'] ?? 'utf8mb4'
        );

        $options = [
            PDO::ATTR_ERRMODE            => PDO::ERRMODE_EXCEPTION,
            PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
            PDO::ATTR_EMULATE_PREPARES   => false,
            PDO::ATTR_STRINGIFY_FETCHES  => false,
        ];

        try {
            $pdo = new PDO($dsn, (string)$dbConfig['username'], (string)($dbConfig['password'] ?? ''), $options);
            $pdo->exec("SET time_zone = '+00:00'");
        } catch (PDOException $e) {
            // Die Originalmeldung kann Host und Benutzername enthalten und
            // gehoert deshalb ins Log, nicht in die Exception-Kette nach aussen.
            Logger::error('Datenbankverbindung fehlgeschlagen', ['error' => $e->getMessage()]);
            throw new RuntimeException('Datenbankverbindung fehlgeschlagen.', 0, $e);
        }

        self::$instance = $pdo;
        return self::$instance;
    }

    /** Alias fuer init(); historisch an mehreren Stellen verwendet. */
    public static function connect(array $config = []): PDO
    {
        return self::init($config);
    }

    public static function getInstance(): PDO
    {
        return self::$instance ?? self::init();
    }

    /**
     * Fuehrt einen Callback in einer Transaktion aus.
     * Verschachtelte Aufrufe laufen in der bereits offenen Transaktion mit.
     *
     * @template T
     * @param callable(PDO):T $callback
     * @return T
     */
    public static function transaction(callable $callback)
    {
        $pdo = self::getInstance();

        if ($pdo->inTransaction()) {
            return $callback($pdo);
        }

        $pdo->beginTransaction();
        try {
            $result = $callback($pdo);
            $pdo->commit();
            return $result;
        } catch (\Throwable $e) {
            if ($pdo->inTransaction()) {
                $pdo->rollBack();
            }
            throw $e;
        }
    }

    /** Aktueller UTC-Zeitstempel im MySQL-DATETIME-Format. */
    public static function nowUtc(): string
    {
        return gmdate('Y-m-d H:i:s');
    }
}