Gibt eine Instanz der Datenbankverbindung zur JobRouter-Datenbank zurück, auf dem Sie anschließend beliebige SQL-Befehle gegen die JobRouter-Datenbank ausführen können.
Im Fehlerfall wirft die Funktion eine JobRouterException.
Beispiel:
$jobDB = $this->getJobDB();
$result = $jobDB->preparedSelect(
'SELECT username FROM JRUSERS WHERE blocked = :blocked',
['blocked' => 1],
[ConnectionInterface::TYPE_INTEGER],
);
$blockedUsers = $result->fetchAll();
Das Objekt stellt folgende Methoden zur Verfügung:
Methode |
Parameter |
Rückgabe |
Beschreibung |
|---|---|---|---|
preparedSelect |
string $sql, array $params, ?array $types = [] |
Führt eine Abfrage mit optionalen Parameter aus (select-Abfrage). Die Parameter werden entsprechend des Spaltentyps, bzw. entsprechend des übergebenen Typs maskiert. |
|
preparedExecute |
string $sql, array $params, ?array $types = [] |
Führt eine Anweisung mit optionalen Parameter aus (insert-, update- oder delete-Anweisung). Die Parameter werden entsprechend des Spaltentyps, bzw. entsprechend des übergebenen Typs maskiert.
Beispiel: $jobDB->preparedExecute( 'UPDATE CATEGORIES SET name = :name WHERE id = :id', ['name' => 'Archiviert', 'id' => 10], [JobRouter\Common\Database\ConnectionInterface::TYPE_TEXT, JobRouter\Common\Database\ConnectionInterface::TYPE_INTEGER], );
|
|
query |
string $statement |
Result-Objekt |
Verwenden Sie diese Methode zum Auslesen von Daten, indem Sie einea SQL-Select Abfrage übergeben. |
exec |
string $statement |
Integer |
Verwenden Sie diese Methode zum Ändern von Daten, indem Sie eine Insert-/Update- oder Delete-Anweisung übergeben. |
quote |
string $value |
String |
Konvertiert den übergebenen Wert in ein DBMS-spezifisches Format, das sich für Query-Statements eignet. |
fetchAll |
Result-Objekt $result |
Array |
Diese Methode liefert alle Zeilen des Abfrageergebnisses zurück. |
fetchRow |
Result-Objekt $result |
Array | false |
Diese Methode liefert den nächsten Datensatz als assoziatives Array zurück. Wenn keine weiteren Datensätze verfügbar sind gibt die Methode false zurück. |
fetchOne |
Result-Objekt $result |
String |
Diese Methode liefert die erste Spalte des nächsten Datensatzes zurück. |
getErrorMessage |
- |
String |
Liefert den zuletzt aufgetretenen Fehler zurück. |
