{"elements":[{"id":7015,"title":"Multi-DBMS","body":"
\n
\n

Supporto Multi-DBMS<\/h2>\n

DressAPI fornisce un livello di astrazione completo su più sistemi di gestione database. Il codice applicativo interagisce con il database tramite un'API unificata, mentre i dettagli specifici del DBMS sono incapsulati in classi driver dedicate.<\/p>\n\n

Database supportati<\/h3>\n
\n \n \n \n
DBMS<\/th>Valore DB_TYPE<\/th>Estensione PHP<\/th>Stato<\/th><\/tr>\n <\/thead>\n
MySQL \/ MariaDB<\/td>MySQL<\/code><\/td>mysqli<\/code><\/td>Produzione<\/td><\/tr>\n
PostgreSQL<\/td>PostgreSQL<\/code><\/td>pgsql<\/code><\/td>Implementato<\/td><\/tr>\n
Oracle<\/td>Oracle<\/code><\/td>oci8<\/code><\/td>Implementato (richiede Oracle 12c+)<\/td><\/tr>\n
SQL Server<\/td>MSSQL<\/code> o SqlServer<\/code><\/td>sqlsrv<\/code><\/td>Implementato (richiede SQL Server 2012+)<\/td><\/tr>\n
PDO (multi-backend)<\/td>PDO<\/code><\/td>PDO<\/code><\/td>Implementato<\/td><\/tr>\n <\/tbody>\n <\/table>\n <\/div>\n\n

Architettura a 3 livelli<\/h3>\n

Il supporto multi-DBMS è costruito su tre livelli, ciascuno con responsabilità chiare:<\/p>\n

    \n
  • CDB (Facade)<\/strong> – Punto di ingresso principale. Accetta un ConnectionManager, crea il driver DBMS corretto tramite CreateDbmsDriver()<\/code>, delega tutte le chiamate IDBMS al driver sottostante e integra il caching.<\/li>\n
  • ConnectionManager (Pool connessioni)<\/strong> – Memorizza i parametri di connessione, gestisce un pool di connessioni con nome e implementa le connessioni lazy (differite fino a GetConnection()<\/code>).<\/li>\n
  • CSqlComposer (Dialetto SQL)<\/strong> – Gestisce le differenze nella sintassi SQL tra i DBMS. Fornisce un'API fluent builder per costruire query in modo portabile.<\/li>\n <\/ul>\n 
    Codice Applicativo (Controller, Model)\n        |                |                |\n        v                v                v\n   CDB (Facade)   CSqlComposer     IDBMS (Interface)\n        |            (Factory)           |\n        v                |               v\nConnectionManager   Composer        Driver DBMS\n(IConnectionMgr)   specifico       specifico\n        |                |               |\n        v                v               v\n   Estensioni PHP (mysqli, pgsql, oci8, sqlsrv, PDO)\n        |\n        v\n   Server Database (MySQL, PostgreSQL, Oracle, MSSQL)<\/pre>\n\n    
    Meccanismo di connessione lazy<\/h3>\n    
    Quando viene chiamato CDB::Connect()<\/code> nel bootstrap, il ConnectionManager memorizza i parametri ma non apre una connessione TCP<\/strong>. La connessione reale avviene solo quando viene eseguita la prima query (o in caso di cache miss).<\/p>\n    
      \n      
    1. Connect()<\/strong> memorizza solo i parametri e restituisce una chiave (formato: hostname:porta.database.username<\/code>)<\/li>\n      
    2. GetConnection()<\/strong> attiva la connessione lazy chiamando RealConnectionForKey()<\/code><\/li>\n      
    3. RealConnectionForKey()<\/strong> apre la connessione TCP effettiva<\/li>\n    <\/ol>\n    
      Vantaggi: bootstrap più veloce, efficienza delle risorse, gestione errori contestuale.<\/p>\n    
      \/\/ Connect() memorizza solo i parametri\npublic function Connect(string $dbname, string $username, string $pwd,\n                        string $hostname, int|string $port): mixed\n{\n    $key = $hostname . ':' . $port . '.' . $dbname . '.' . $username;\n    $this->connection_params[$key] = [\n        'hostname' => $hostname,\n        'username' => $username,\n        'password' => $pwd,\n        'database' => $dbname,\n        'port'     => (int)$port\n    ];\n    return $key;  \/\/ Restituisce una chiave, NON un handle di connessione\n}<\/pre>\n\n    
      Costanti di configurazione<\/h3>\n    
      Definisci queste costanti nel file config.php<\/code> della tua applicazione:<\/p>\n    
      define('DB_TYPE',     'MySQL');      \/\/ MySQL, PostgreSQL, Oracle, MSSQL, SqlServer, PDO\ndefine('DB_HOST',     'localhost');\ndefine('DB_PORT',     3306);         \/\/ MySQL: 3306, PostgreSQL: 5432, Oracle: 1521, MSSQL: 1433\ndefine('DB_NAME',     'my_database');\ndefine('DB_USERNAME', 'db_user');\ndefine('DB_PASSWORD', 'db_password');<\/pre>\n\n    
      Factory Pattern in CSqlComposer<\/h3>\n    
      CSqlComposer<\/code> è una classe final<\/code> che usa l'espressione match<\/code> di PHP come factory per creare il composer specifico del DBMS:<\/p>\n    
      final class CSqlComposer implements ISqlComposer\n{\n    protected mixed $composer;\n\n    public function __construct(string $dbms_type, ?string $items = '*', ...)\n    {\n        $this->composer = match($dbms_type)\n        {\n            'mysql'              => new CMySqlComposer($items, $table, ...),\n            'postgresql'         => new CPostgreSqlComposer($items, $table, ...),\n            'oracle'             => new COracleComposer($items, $table, ...),\n            'mssql', 'sqlserver' => new CMsSqlComposer($items, $table, ...),\n            default              => throw new InvalidArgumentException(\n                                        \"Unknown DBMS type: $dbms_type\")\n        };\n    }\n}<\/pre>\n    
      Gerarchia delle classi:<\/p>\n    
      ISqlComposer (interfaccia)\n    |\n    +-- CSqlComposerBase (base astratta - SQL standard)\n    |       +-- CMySqlComposer\n    |       +-- CPostgreSqlComposer\n    |       +-- COracleComposer\n    |       +-- CMsSqlComposer\n    |\n    +-- CSqlComposer (factory\/wrapper finale - delega alle classi sopra)<\/pre>\n\n    
      Mapping tipi specifici per DBMS<\/h3>\n    
      \n      \n        \n          \n          
      Tipo logico<\/th>MySQL<\/th>PostgreSQL<\/th>Oracle<\/th>SQL Server<\/th><\/tr>\n        <\/thead>\n        
      DB_TYPE_ID<\/td>INT<\/td>SERIAL<\/td>NUMBER<\/td>INT<\/td><\/tr>\n          
      DB_TYPE_NAME<\/td>VARCHAR<\/td>VARCHAR<\/td>VARCHAR2<\/td>NVARCHAR<\/td><\/tr>\n          
      DB_TYPE_INT<\/td>INT<\/td>INTEGER<\/td>NUMBER<\/td>INT<\/td><\/tr>\n          
      DB_TYPE_DATE<\/td>DATE<\/td>DATE<\/td>DATE<\/td>DATE<\/td><\/tr>\n          
      DB_TYPE_DATETIME<\/td>DATETIME<\/td>TIMESTAMP<\/td>TIMESTAMP<\/td>DATETIME2<\/td><\/tr>\n          
      DB_TYPE_SET<\/td>SET<\/td>TEXT[]<\/td>VARCHAR2<\/td>NVARCHAR<\/td><\/tr>\n          
      DB_FUNC_NOW<\/td>date('Y-m-d H:i:s')<\/td>NOW()<\/td>SYSDATE<\/td>GETDATE()<\/td><\/tr>\n        <\/tbody>\n      <\/table>\n    <\/div>\n\n    
      Interfaccia ConnectionManager<\/h3>\n    
      Ogni DBMS implementa l'interfaccia IConnectionManager<\/code>:<\/p>\n    
      \n      \n        \n          \n          
      Metodo<\/th>Scopo<\/th><\/tr>\n        <\/thead>\n        
      Connect()<\/code><\/td>Memorizza i parametri e restituisce una chiave di connessione (NON apre una connessione)<\/td><\/tr>\n          
      GetConnection()<\/code><\/td>Restituisce l'handle di connessione, aprendolo in modo lazy se necessario<\/td><\/tr>\n          
      HasConnection()<\/code><\/td>Verifica se una connessione esiste (parametri memorizzati O già connesso)<\/td><\/tr>\n          
      RealConnection()<\/code><\/td>Forza l'apertura della connessione TCP<\/td><\/tr>\n          
      Disconnect()<\/code><\/td>Chiude una connessione specifica<\/td><\/tr>\n          
      DisconnectAll()<\/code><\/td>Chiude tutte le connessioni aperte<\/td><\/tr>\n          
      GetDbmsType()<\/code><\/td>Restituisce l'identificativo del DBMS (es. mysql<\/code>, postgresql<\/code>)<\/td><\/tr>\n          
      SetAutoCommit()<\/code><\/td>Abilita o disabilita l'autocommit su tutte le connessioni<\/td><\/tr>\n        <\/tbody>\n      <\/table>\n    <\/div>\n\n    
      API builder SqlComposer<\/h3>\n    
      L'API fluent consente di costruire query portabili tra DBMS:<\/p>\n    
      $sql = new CSqlComposer('mysql');\n$sql->Select('id, name, email')\n    ->From('users')\n    ->Where('active = ?', [1], ['i'])\n    ->OrderBy(['name'])\n    ->Paging(1, 20);\n\n$query = $sql->Prepare();\n\/\/ MySQL:      \"SELECT id, name, email FROM users WHERE (active = ?) ORDER BY name LIMIT 0,20\"\n\/\/ PostgreSQL: \"... LIMIT 20 OFFSET 0\"\n\/\/ Oracle:     \"... OFFSET 0 ROWS FETCH NEXT 20 ROWS ONLY\"\n\/\/ SQL Server: \"... OFFSET 0 ROWS FETCH NEXT 20 ROWS ONLY\"<\/pre>\n\n    
      Passaggio tra DBMS<\/h3>\n    
      Basta cambiare la costante DB_TYPE<\/code> nel file config.php<\/code> e tutto il resto si adatta automaticamente:<\/p>\n    
        \n      
      1. Installa l'estensione PHP richiesta per il DBMS di destinazione<\/li>\n      
      2. Aggiorna DB_TYPE<\/code>, DB_HOST<\/code>, DB_PORT<\/code> nel config.php<\/code><\/li>\n      
      3. Migra lo schema del database (crea le tabelle framework con la sintassi appropriata)<\/li>\n    <\/ol>\n    
        \/\/ PostgreSQL\ndefine('DB_TYPE', 'PostgreSQL');\ndefine('DB_PORT', 5432);\n\n\/\/ Oracle\ndefine('DB_TYPE', 'Oracle');\ndefine('DB_PORT', 1521);\n\n\/\/ SQL Server\ndefine('DB_TYPE', 'MSSQL');\ndefine('DB_PORT', 1433);<\/pre>\n\n    
        Differenze specifiche per DBMS<\/h3>\n\n    
        Paginazione<\/h4>\n    
        \n      \n        \n          \n          
        DBMS<\/th>Sintassi SQL<\/th><\/tr>\n        <\/thead>\n        
        MySQL<\/td>LIMIT offset, count<\/code><\/td><\/tr>\n          
        PostgreSQL<\/td>LIMIT count OFFSET offset<\/code><\/td><\/tr>\n          
        Oracle (12c+)<\/td>OFFSET n ROWS FETCH NEXT m ROWS ONLY<\/code><\/td><\/tr>\n          
        SQL Server (2012+)<\/td>OFFSET n ROWS FETCH NEXT m ROWS ONLY<\/code> (richiede ORDER BY<\/code>)<\/td><\/tr>\n        <\/tbody>\n      <\/table>\n    <\/div>\n\n    
        Quoting degli identificatori<\/h4>\n    
        \n      \n        \n          \n          
        DBMS<\/th>Stile<\/th>Esempio<\/th><\/tr>\n        <\/thead>\n        
        MySQL<\/td>Backtick<\/td>`nome_colonna`<\/code><\/td><\/tr>\n          
        PostgreSQL<\/td>Doppi apici<\/td>"nome_colonna"<\/code><\/td><\/tr>\n          
        Oracle<\/td>Doppi apici<\/td>"nome_colonna"<\/code><\/td><\/tr>\n          
        SQL Server<\/td>Parentesi quadre<\/td>[nome_colonna]<\/code><\/td><\/tr>\n        <\/tbody>\n      <\/table>\n    <\/div>\n\n    
        Concatenazione stringhe<\/h4>\n    
        \n      \n        \n          \n          
        DBMS<\/th>Metodo<\/th>Sintassi<\/th><\/tr>\n        <\/thead>\n        
        MySQL<\/td>Funzione CONCAT()<\/td>CONCAT(a, b, c)<\/code><\/td><\/tr>\n          
        PostgreSQL<\/td>Operatore ||<\/td>a || b || c<\/code><\/td><\/tr>\n          
        Oracle<\/td>Operatore ||<\/td>a || b || c<\/code><\/td><\/tr>\n          
        SQL Server<\/td>Operatore +<\/td>a + b + c<\/code><\/td><\/tr>\n        <\/tbody>\n      <\/table>\n    <\/div>\n\n    
        Ricerca full-text<\/h4>\n    
        \n      \n        \n          \n          
        DBMS<\/th>Sintassi<\/th><\/tr>\n        <\/thead>\n        
        MySQL<\/td>MATCH(colonne) AGAINST('testo')<\/code><\/td><\/tr>\n          
        PostgreSQL<\/td>to_tsvector(colonne) @@ plainto_tsquery('testo')<\/code><\/td><\/tr>\n          
        Oracle<\/td>CONTAINS(colonne, 'testo')<\/code> con SCORE()<\/code><\/td><\/tr>\n          
        SQL Server<\/td>CONTAINS(colonne, 'testo')<\/code><\/td><\/tr>\n        <\/tbody>\n      <\/table>\n    <\/div>\n\n    
        Sintassi dei placeholder<\/h4>\n    
        \n      \n        \n          \n          
        DBMS<\/th>Stile<\/th><\/tr>\n        <\/thead>\n        
        MySQL<\/td>?<\/code> (posizionale)<\/td><\/tr>\n          
        PostgreSQL<\/td>$1, $2, $3<\/code> (convertiti da ?<\/code>)<\/td><\/tr>\n          
        Oracle<\/td>:bind1, :bind2<\/code> (named bind)<\/td><\/tr>\n          
        SQL Server<\/td>?<\/code> (posizionale)<\/td><\/tr>\n          
        PDO<\/td>?<\/code> (posizionale)<\/td><\/tr>\n        <\/tbody>\n      <\/table>\n    <\/div>\n\n    
        Gerarchia delle eccezioni<\/h3>\n    
        Exception\n    |\n    +-- CDbmsException           (base per tutte le eccezioni DBMS)\n            |\n            +-- CConnectionException  (errori di connessione)\n            +-- CQueryException        (errori di esecuzione query, include la stringa SQL)<\/pre>\n    
        \n      \n        \n          \n          
        Eccezione<\/th>Quando viene lanciata<\/th>Dati extra<\/th><\/tr>\n        <\/thead>\n        
        CDbmsException<\/code><\/td>Classe base per tutti gli errori DB<\/td>Campi standard Exception<\/td><\/tr>\n          
        CConnectionException<\/code><\/td>Connessione fallita, tipo DBMS non supportato<\/td>Messaggio, codice, eccezione precedente<\/td><\/tr>\n          
        CQueryException<\/code><\/td>Errore esecuzione SQL<\/td>GetSql()<\/code> restituisce la query fallita<\/td><\/tr>\n        <\/tbody>\n      <\/table>\n    <\/div>\n\n    
        Riferimento classi e mappa file<\/h3>\n    
        Tutti i file si trovano in core\/src\/dbms\/<\/code>:<\/p>\n    
        core\/src\/dbms\/\n    Interfacce:\n    +-- IDBMS.php                        # Interfaccia driver DBMS\n    +-- IConnectionManager.php           # Interfaccia pool connessioni\n    +-- ISqlComposer.php                 # Interfaccia SQL builder\n\n    Facade \/ Factory:\n    +-- CDB.php                          # Classe facade principale\n    +-- CSqlComposer.php                 # Factory\/proxy per SQL composer\n    +-- CSqlComposerBase.php             # Base astratta per SQL composer\n\n    MySQL:\n    +-- CMySqlDb.php                     # Driver MySQL (mysqli)\n    +-- CMySqlConnectionManager.php      # Pool connessioni MySQL\n    +-- CMySqlComposer.php               # Dialetto SQL MySQL\n\n    PostgreSQL:\n    +-- CPostgreSqlDb.php                # Driver PostgreSQL (pgsql)\n    +-- CPostgreSqlConnectionManager.php # Pool connessioni PostgreSQL\n    +-- CPostgreSqlComposer.php          # Dialetto SQL PostgreSQL\n\n    Oracle:\n    +-- COracleDb.php                    # Driver Oracle (oci8)\n    +-- COracleConnectionManager.php     # Pool connessioni Oracle\n    +-- COracleComposer.php              # Dialetto SQL Oracle\n\n    SQL Server:\n    +-- CMsSqlDb.php                     # Driver SQL Server (sqlsrv)\n    +-- CMsSqlConnectionManager.php      # Pool connessioni SQL Server\n    +-- CMsSqlComposer.php               # Dialetto SQL SQL Server\n\n    PDO:\n    +-- CPdoDb.php                       # Driver PDO (multi-backend)\n    +-- CPdoConnectionManager.php        # Pool connessioni PDO\n\n    Eccezioni:\n    +-- CDbmsException.php               # Eccezione base DBMS\n    +-- CConnectionException.php         # Eccezione connessione fallita\n    +-- CQueryException.php              # Eccezione esecuzione query<\/pre>\n  <\/div>\n<\/section>\n\n
        \n  ← Torna ai Tutorial<\/a>\n<\/section>","description":"Supporto multi-database: MySQL, PostgreSQL, Oracle, SQL Server e PDO. Architettura a 3 livelli, connessione lazy e astrazione SQL.","meta_keywords":"","visible":"yes","status":"public","creation_date":"0000-00-00","id__user":1,"priority":0,"groupname":"TUTORIAL"}],"module":"pages","permissions":{"can_read":true},"main_item_title":"title","related_tables":[{"name":"Newsonpage","module":"newsonpage","FK":"id_cmspage","permissions":[]}],"page_info":{"table":"","key":"id","url":"\/pages","url_list":"\/pages","filters":{"id":["=","7015"]},"pagination":{"total_items":23,"page":1,"total_pages":2,"step":1,"items_per_page":20,"url_prev":"\/pages","url_next":"\/pages\/p\/2","url_tmpl":"\/pages\/p\/[[p]]","url_tmpl_with_order":"\/pages\/p\/[[p]]\/ob\/[[ob]]"},"order":{"field":"id","type":"DESC","url_tmpl":"\/pages\/p\/[[p]]"},"module":{"title":"Pages","description":"List of pages","name":"pages"},"current":{"title":"Pages","description":"List of pages","name":"pages","url":"\/tutorials\/multi-dbms"}},"components":{"alert":{"alert1":[{"type":"warning","message":"OK COMPONENT!"},{"type":"danger","message":"ERROR COMPONENT!"}]}},"messages":[]}