<?php
// src/model/DB.php

// cette classe applique le pattern "singleton", il empêche la classe PDO d'être instanciée plusieurs fois
// l'instance est récupérable partout mais sans les inconvénients d'une variable globale

// comment?
// - le constructeur est privé, c'est à cette condition que l'instanciation devient contrôlable
// - notre instance unique est stockée dans un attribut privé et statique
// - une méthode statique appele le contructeur si l'instance unique n'existe pas encore, puis retourne l'instance

class DB extends PDO
{
    // paramètres du constructeur de PDO
    public static $dsn = ''; // Data Source Name = préfixe + hôte + port + nom de la base + encodage
    //~ public static $user = '';
    //~ public static $password = '';
    //~ public static $options = '';
    
    private static $Instance;
    
    private function __construct() // exécuté une seul fois à cause du "if" dans getInstance()
    {
        try
        {
            parent::__construct(self::$dsn); // => PDO::$dsn
            //$this->setAttribute(PDO::MYSQL_ATTR_INIT_COMMAND, 'SET NAMES utf8'); // pour mysql/mariadb
            $this->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION); // $this pour la méthode du parent PDO
            $this->setAttribute(PDO::ATTR_DEFAULT_FETCH_MODE, PDO::FETCH_ASSOC); // pour PDO:fetch() et PDO::fetchAll()
            // avec PDO::FETCH_ASSOC on obtient un tableau associatif, marche très bien puisqu'on utilise déjà des ID avec incrémentation automatique
            // avec PDO::FETCH_BOTH (par défaut) on récupère les données en double (identifiants partant de 0 + tableau associatif)
        }
        catch(PDOException $e)
        {
            die("Impossible de se connecter à la base de données.\n" . $e->getMessage());
        }
    }
    
    // créer son objet depuis Model avec: $db = parent::getInstance();
    public static function getInstance(): self
    {
        if(self::$Instance === null)
        {
            self::$Instance = new self;
        }
        return self::$Instance;
    }
}