...
If the third parameter contains several conditions these will be ANDed.
buildUpdate()
Während update() die Anweisung zusammenbaut und auch gleich ausführt, liefert buildUpdate() die zusammengebaute Anweisung zurückWhile update() creates an UPDATE statement and executes it immediatly, buildUpdate() will just create and return the statement. This is usefull if the statement should be used otherwise (e.g. logged) before being executed.
| Code Block | ||||
|---|---|---|---|---|
| ||||
// string buildUpdate(string $tablename, array $fields, array $where)
$idcode = 123;
$code = "<html>... more code n' fun ...</html>";
$fields = array(
'code' => $code,
);
$where = array(
'idcode' => (int) $idcode
);
$cfg = cRegistry::getConfig();
$db = cRegistry::getDb();
$sql = $db->buildUpdate($cfg['tab']['code'], $fields, $where);
$result = $db->query($sql); |
toArray()
Dei neue Funktion toArray() liefert den aktuellen Datensatz, als Array zurück. Dabei ist es möglich den Datensatz als assoziatives und/oder indexiertes Array zurückzuliefern. Per default wird ein assoziatives Array zurückgeliefertThe new method toArray() returns the current records data as array. This method allows for returning a normal (idexed) or even an associative array. An associative array will be returned by default.
| Code Block | ||||
|---|---|---|---|---|
| ||||
// string toArray(string $fetchmode)
$idlang = 1;
$idart = 2;
$cfg = cRegistry::getConfig();
$db = cRegistry::getDb();
$sql = $db->prepare('SELECT * FROM `%s` WHERE idart = %d AND idlang = %d', $cfg['tab']['art_lang'], $idart, $idlang);
$db->query($sql);
if ($db->nextRecord()) {
$assocRs = $db->toArray(); // oder mit Parameter cDbDriverHandler::FETCH_ASSOC
echo "<pre>\$assocRs: " . print_r($assocRs, true) . "<pre>";
$indexedRs = $db->toArray(cDbDriverHandler::FETCH_NUMERIC);
echo "<pre>\$indexedRs: " . print_r($indexedRs, true) . "<pre>";
$bothdRs = $db->toArray(cDbDriverHandler::FETCH_BOTH);
echo "<pre>\$bothdRs: " . print_r($bothdRs, true) . "<pre>";
} |
toObject()
Dei neue Funktion toObject() liefert den aktuellen Datensatz, als Objekt zurück das eine Instanz von stdClass ist (Standard Klasse in PHP). Die Eigenschaften des Objekts entsprechen den Feldnamen der TabelleThe new method toObject() returns the current records data as object, being an instance of the class stdClass which is a standard class in PHP. The objects members correspond to the tables column names.
| Code Block | ||||
|---|---|---|---|---|
| ||||
// string toObject(string $fetchmode)
$idlang = 1;
$idart = 2;
$cfg = cRegistry::getConfig();
$db = cRegistry::getDb();
$sql = $db->prepare('SELECT * FROM `%s` WHERE idart = %d AND idlang = %d', $cfg['tab']['art_lang'], $idart, $idlang);
$db->query($sql);
if ($db->nextRecord()) {
$rs = $db->toObject();
echo "<pre>\$rs: " . print_r($rs, true) . "<pre>";
echo "<pre>idartlang: " . $rs->idartlang . "<pre>";
echo "<pre>title: " . $rs->title . "<pre>";
echo "<pre>author: " . $rs->author . "<pre>";
} |
escape()
Mit der neuen Funktion The new method escape() kann man Variablen vom Typ String bei Bedarf escapen. Diese Funktion ist eine Alternative zu allows for escaping strings when required. It is an alternative to cSecurity::escapeDB().
| Code Block | ||||
|---|---|---|---|---|
| ||||
// string escape(string $str) $db = cRegistry::getDb(); $code = "<html>... more code n' fun ...</html>"; $escapedCode = $db->escape($code); // Zuvor war dies folgendermaßen möglich $db = cRegistry::getDb(); $code = "<html>... more code n' fun ...</html>"; $escapedCode = cSecurity::escapeDB($code, $db); |
These were the most important changes of the database class cDb and its predecessors. Developers now have more options to create SQL statements.
Das waren die wichtigsten Neuerungen in den Datenbank-Klassen cDb und Eltern-Klassen. Entwickler haben nun mehr Möglichkeiten, um SQL-Anweisungen zu generieren, zum Teil ist das Erstellen der SQL-Anweisungen einfacher sowie lesbarer geworden und der Sicherheitsaspekt wurde zum Teil in die DB-Adapter verlagert.