Initial xentral_oss_20.3.c9ffacf

classes/Components/Database/docs/query_builder.md

@@ -0,0 +1,97 @@
+# SQL Query Builder
+
+###### Verwendete Libraries
+
+* **Aura.SqlQuery**:
+  * Composer: `aura/sqlquery:2.7.*`
+  * Packagist: https://packagist.org/packages/aura/sqlquery
+  * GitHub: https://github.com/auraphp/Aura.SqlQuery
+  * Docs: https://github.com/auraphp/Aura.SqlQuery/tree/2.x
+
+## Query Builder erzeugen
+
+```php
+$select = $db->select();
+$update = $db->update();
+$insert = $db->insert();
+$delete = $db->delete();
+```
+
+## SELECT-Query
+
+https://github.com/auraphp/Aura.SqlQuery/tree/2.x#select
+
+###### Beispiel mit Named-Placeholder
+
+```php
+$select = $db->select();
+$select
+    ->cols(['u.id', 'u.description'])
+    ->from('user AS u')
+    ->where('u.id = :user_id')
+    ->bindValue('user_id', 1);
+
+$result = $db->fetchAll(
+    $select->getStatement(),
+    $select->getBindValues()
+);
+
+var_export($result);
+// array(
+//     0 => array(
+//         'id' => 1,
+//         'description' => 'Administrator',
+//     ),
+// )
+```
+
+###### Alternative mit ?-Placeholder
+
+```php
+$select = $db->select();
+$select
+    ->cols(['u.id', 'u.description'])
+    ->from('user AS u')
+    ->where('u.id = ?', 1);
+```
+
+###### Beispiel mit Verschachtelung im WHERE
+
+```php
+$select = $db->select();
+$select
+    ->cols(['u.id', 'u.description'])
+    ->from('user AS u')
+    ->where('u.activ = ?', 1)
+    ->where(function (SelectQuery $query) {
+        $query->where('u.type = ?', 'admin')
+            ->orWhere('u.type = ?', 'standard');
+    });
+
+echo $select->getStatement();
+```
+```sql
+SELECT
+    `u`.`id`,
+    `u`.`description`
+FROM
+    `user` AS `u`
+WHERE
+   `u`.`activ` = :_1_1_
+   AND (
+       `u`.`type` = :_1_2_
+       OR `u`.`type` = :_1_3_
+   )
+```
+
+## INSERT-Query
+
+https://github.com/auraphp/Aura.SqlQuery/tree/2.x#insert
+
+## UPDATE-Query
+
+https://github.com/auraphp/Aura.SqlQuery/tree/2.x#update
+
+## DELETE-Query
+
+https://github.com/auraphp/Aura.SqlQuery/tree/2.x#delete