Ez az osztály az adatbázisokhoz való kapcsolódást teszi lehetővé.

Az objektum létrehozáskor azonnal kapcsolódik. A következő konstruktorai vannak:

CDatabase()

A appconfig.inc.php-ban definiált default kapcsolatot adja vissza. Amennyiben az ini fájlban engedélyezve van a permanens kapcsolat (alapértelmezetten engedélyezve van), akkor nem kapcsolódik újra, hanem ezt a permanens kapcsolatot adja vissza.

CDatabase(string database)

Az alapértelmezett szerveren kapcsolódik a megadott adatbázishoz.

CDatabase(string type, string user, string password [, string host [, string database [, int port]]])

Általános adatbáziskapcsolat nyitása.

A paraméterek jelentése:

• type: az adatbázis tipusa; lehet (a felsoroltak nem feltétlenül vannak belefordítva a programba):
  1. postgres
  2. mysql
  3. interbase
  4. sqlite
• user: a kapcsolódáshoz szükséges felhasználó név
• password: a kapcsolódáshoz szükséges jelszó
• host: az adatbázis szerver
• database: az adatbázis neve
• port: az adatbázis portja; ha 0-t adunk meg az adott adatbázis tipushoz használt alapértelmezett portot használja (ez az alapérték is)

A megfelelő elemek elhagyásakor az appconfig.inc.php-ban definiált konstansok lesznek felhasználva, ezek rendre: DB_TYPE, DB_USER, DB_PASS, DB_HOST, DB_DEFAULT és DB_PORT.

Az SQLite adatbáziskezelő egyetlen fájlt használ és felhasználó azonosítás sincs benne, ezért ebben az esetben a database paraméterben (illetve a DB_DEFAULT konstansban) az adatbázis fájl nevét kell megadni, a többi paramétert figyelmen kívül hagyja.

mixed queryAsArray(string query [, bool simple])

A query paraméterben megadott lekérdezést végrehajtja és a második paramétertől függő formában visszaadja.

Amennyiben a második paraméter false, akkor az eredmény tömbben az eredmény első oszlopával lesz indexelve a többi oszlop. (A lista ilyen formában várja az adatot)

Amennyiben a második paraméter true, akkor az eredménynek csak az első két oszlopa számít, ekkor az első oszloppal lesz indexelve a második oszlop. (A combobox ilyen formában várja az adatot)

Hiba esetén a visszatérési érték a hibaüzenet, illetve üres lekérdezés esetén az 'empty' szöveg.

string query(string query)

A paraméterben megadott lekérdezést végrehajtja. Ezután az eredményhez a fetchRow metódussal tudunk hozzáférni.

Hiba esetén a visszatérési érték a hibaüzenet, siker esetén üres string.

mixed queryAsString(string query)

A paraméterben megadott lekérdezést végrehajtja. A visszaadott érték a lekérdezés első sorának első oszlopa. Azaz amennyiben az eredmény egy sort adott és a lekérdezés egy oszlopra vonatkozott, akkor a visszatérési érték maga az eredmény.

Hiba esetén false értéket kapunk.

mixed fetchRow()

A query metódussal lekérdezett eredmény következő sorával tér vissza egy associatív tömbben, illetve a false értékkel, ha nincs már több sor. Az eredmény tömbben a mező nevével van indexelve az értéke.

string insert(string table, array values)

A beszúrást segítő metódus, ami a table paraméterben megadott táblába szúr be egy sort úgy, hogy a values minden egyes értéke “kulcs” = “érték” formában tárolásra kerül. Az értékek kezelése megfelelően történik (a PHP NULL értékből SQL null érték lesz, a PHP boolean tipusból SQL boolean stb.)

Például a következő metódus hívás az INSERT INTO irszam(varos,irszam,aktiv) VALUES (5,'5555',true) SQL utasítást eredményezi:

$db->Insert('irszam',array('varos'=>5,
                           'irszam'=>'5555',
                           'aktiv'=>true
                           ));

void disconnect()

Megszünteti a kapcsolatot a szerverrel. Ezután nem szabad végrehajtani lekérdezést.

void StartTransaction()

Nyit egy új tranzakciót. A jelenleg támogatott adatbáziskezelők egyike sem tudja az egymásba ágyazott tranzakciókat kezelni, ezért tranzakción belül új tranzakció nyitása hatástalan.

void EndTransaction()

Lezárja a tranzakciót. Nem ad hibát, ha előtte nem volt nyitott tranzakció (ekkor nyilván nincs hatása).

void Rollback()

A nyitott tranzakciót semmissé teszi. Nem ad hibát, ha előtte nem volt nyitott tranzakció (ekkor nyilván nincs hatása).