====== dbStore() ======

Die Funktion ''dbStore()'' legt ein Datenobjekt in der [[:de:create:databank]] ab.

''void **dbStore**(string //Schlüssel//, mixed //Datenobjekt//)''

  * //Schlüssel//\\ Der Datenbank-Schlüssel, der angelegt, aktualisiert oder gelöscht werden soll. Der Schlüssel muss zwischen 2 und 63 Zeichen lang sein. Umlaute benötigen u.U. mehr als ein Zeichen.
  * //Datenobjekt//\\ Dies kann ein Einzelwert sein oder ein indiziertes oder assoziatives Array. Auch verschachtelte Arrays sind möglich.

Beachten Sie, dass Objekte, die sie mittels ''dbStore()'' in der Datenbank für Inhalte ablegen, nur mittels ''[[:de:create:functions:dbretrieve]]'' ausgelesen werden können, nicht mittels ''[[:de:create:functions:dbget]]''.


==== Anwendungsbeispiel ====

Folgender PHP-Code würde mit den benannten Array-Indizes ''age'', ''gender'' und ''response'' zwei Antwort-Werte und alle Antworten aus der Skala AB01 als Array speichern.

<code php>
$data = [
  'age' => value('SD01_01'),
  'gender' => value('SD02'),
  'response' => valueList('AB01')
];
$person = caseSerial();
dbStore($person, $data);
</code>

In der Datenbank für Inhalte wäre dann z.B. folgendes Objekt hinterlegt.

<code json>
{
    age: 19,
    gender: 2,
    response: {
        AB01_01 => 3,
        AB01_02 => 1,
        AB01_03 => 2,
        AB01_04 => 3
    }
}
</code>