EzDatabase (EzTools)

Beschreibung

EzDatabase ist die Datenbankzugriffsklasse der EzTools. Viele andere Klassen erben von ihr oder verwenden sie. Die Klasse hat nicht die Aufgabe als Datenbankwrapper zu fungieren, sie ist ausschließlich für MySQL gedacht. Sie kapselt deshalb auch nicht alle möglichen Datenbankfunktionen. Ihre Aufgabe ist eine einheitliche und einfache Fehlerbehandlung in Anwendungen und die Bereitstellung von DB-Hilfsfunkionen.

Sobald in einer Datenbankoperation ein Fehler festgestellt wird, wird eine art Alert-Box mit einer detaillierten Fehlermeldung ausgegeben, und der weitere Programmablauf abgebrochen.

Relevante Methoden

void connect(boolean selectstandard)

Stellt eine Verbindung zur Datenbank her. Verbindungsparameter werden EzConf entnommen.
Parameter:

• boolean $selectstandard: true: Nach der Verbindung wird die konfigurierte standard-Datenbank per mysql_select_db() selektiert.

Return:

• nichts

boolean is_connected()

Prüft ob eine Datenbankverbindung besteht
Parameter:

• keine

Return:

• boolean: true: Datenbankverbindung besteht

void close()

Schließt eine bestehende Datenbankverbindung
Parameter:

• keine

Return:

• nichts

void createDb(string db)

Erstellt eine neue Datenbank.
Parameter:

• string db: Name der neuen Datenbank

Return:

• nichts

void selectDb(string db)

Wechselt zur angegebenen Datenbank
Parameter:

• string db: Name der Datenbank
• bool create: (optional) Wenn Datenbank nicht vorhanden, erzeugen. Default ist false

Return:

• nichts

resource query(string sql)

Führt eine SQL-Abfrage mit Fehlerbehandlung durch
Parameter:

• string $sql: String mit SQL-Abfrage

Return:

• resource: Result aus mysql_query()

boolean tableExists(string table)

Prüft ob eine Datenbanktabelle existiert
Parameter:

• string $table: Name der Tabelle

Return:

• bool: true: Tabelle existiert, false sie existiert nicht.

string[] datetime2dt(string datetime)

Wandelt einen MySQL-Datetime-String in eine Datums- und Zeitangabe in deutscher Schreibweise um
Parameter:

• string $datetime: Datetime-Wert aus einer MySQL-Tabelle

Return:

• string[0]: Datumswert (tt.mm.jjjj), string[1] Zeit (hh:mm)

string tstamp2mysql(string timestamp)

Wandelt einen Unix-Timestamp zu einem MySQL-Datumsstring
Parameter:

• string $timestamp: der Timestamp

Return:

• string: MySQL-Datumsstring

array parseDatetime(string datetime)

Ist ein synonym für datetime2dt() und gleicht in allen Belangen dieser Funktion

string parseDate(string date)

Wandelt einen MySQL-Date-String in eine Datumsangabe deutscher Schreibweise um
Parameter:

• string $datetime: Datetime-Wert aus einer MySQL-Tabelle

Return:

• string: Datumswert (tt.mm.jjjj)

string convPrice(string price)

Wandelt eine Festkomma Zahl in eine Zahlen-String mit zei Nachkommostellen und einem Komma als Trennzeichen.
Parameter:

• string $datetime: Datetime-Wert aus einer MySQL-Tabelle

Return:

• string: Datumswert (tt.mm.jjjj)

Beispiel:

string getMonthName(int month, bool short=false)

Liefert den deutschen namen eines Monats
Parameter:

• int $month: Nummer des Monats (1-12)
• bool $short: false = voller Name (z.B. Januar), true = Abkürzung (Jan)

Return:

• string: Monatsname

Beispiel:

int rowCount(string sql)

Liefert die Anzahl der Datensätze, die ein Query liefert
Parameter:

• string $sql : SQL-Query String

Return:

• int: Anzahl der Datensätze

Benötigt

• EzConf
• EzPage

Beispiel

...tbd...

Siehe auch

• EzTools