Update sourc guide

Author: sclubricants

user_guide_src/source/database/query_builder/112.php

@@ -0,0 +1,14 @@
+<?php
+
+$data = [
+    'email'   => '[email protected]',
+    'name'    => 'Ahmadinejad',
+    'country' => 'Iran',
+];
+
+$builder->upsert($data);
+// MySQLi  produces: INSERT INTO.. ON DUPLICATE KEY UPDATE..
+// Postgre produces: INSERT INTO.. ON CONFLICT.. DO UPDATE..
+// SQLite3 produces: INSERT INTO.. ON CONFLICT.. DO UPDATE..
+// SQLSRV  produces: MERGE INTO.. WHEN MATCHED THEN UPDATE.. WHEN NOT MATCHED THEN INSERT..
+// OCI8    produces: MERGE INTO.. WHEN MATCHED THEN UPDATE.. WHEN NOT MATCHED THEN INSERT..

user_guide_src/source/database/query_builder/113.php

@@ -0,0 +1,11 @@
+<?php
+
+class Myclass
+{
+    public $email   = '[email protected]';
+    public $name    = 'Ahmadinejad';
+    public $country = 'Iran';
+}
+
+$object = new Myclass();
+$builder->upsert($object);

user_guide_src/source/database/query_builder/114.php

@@ -0,0 +1,18 @@
+<?php
+
+$data = [
+    'email'   => '[email protected]',
+    'name'    => 'Ahmadinejad',
+    'country' => 'Iran',
+];
+
+$sql = $builder->setData($data)->getCompiledUpsert();
+echo $sql;
+/* MySQLi produces:
+    INSERT INTO `db_user` (`country`, `email`, `name`)
+    VALUES ('Iran','[email protected]','Ahmadinejad')
+    ON DUPLICATE KEY UPDATE
+    `country` = VALUES(`country`),
+    `email` = VALUES(`email`),
+    `name` = VALUES(`name`)
+*/