Merge pull request #5 from iazaran/search_method

Search method

Author: iazaran

README.md

@@ -9,7 +9,7 @@
 - **Get information about the tables and columns**
 The `information` method can generate information about the tables and columns. So frontend can see the columns and their types.
 - **Generate simple CRUD automatically**
-The `create`, `read`, `update` and `delete` methods can accept the different parameters that determine the target table(s) and column(s) to apply CRUD. You can add your custom method to do more process on specific requests. (WIP: adding action to the existing method to handle specific requests and processes)
+The `create`, `read`, `update` and `delete` methods can accept the different parameters that determine the target table(s) and column(s) to apply CRUD. You can add your custom method to do more process on specific requests.
 - **Can be used by a single endpoint in API**
 This package doesn't serve API features, but you can set an endpoint to accept those parameters and do CRUD features like GraphQL.
 
@@ -35,6 +35,8 @@ $generatrixCRUD::create(['tt_countries' => ['countryCode' => ['US', 'GB'], 'coun
 $generatrixCRUD::update(237, ['tt_countries' => ['countryCode' => 'ES', 'countryName' => 'Spain']]);
 // Delete specific row
 $generatrixCRUD::delete(237, ['tt_countries']);
+// Search for multiple columns (AND, OR, XOR, ...) of target table (=, LIKE, NOT, ...) and list them ('AND' will be considered for joining conditions of conditions) You can add relationships like read method
+$generatrixCRUD::search(['OR' => ['=' => ['cityName' => 'dubai'], 'LIKE' => ['cityName' => 'old']]], ['tt_cities' => ['cityName']]);
 ```
 
 ------------

samples.php

@@ -49,6 +49,9 @@ public static function groupByFirstColumn(...$responses): array
 
     // Delete specific row
     var_dump($generatrixCRUD::delete(237, ['tt_countries']));
+
+    // Search for multiple columns (AND, OR, XOR, ...) of target table (=, LIKE, NOT, ...) and list them ('AND' will be considered for joining conditions of conditions) You can add relationships like read method
+    var_dump($generatrixCRUD::search(['OR' => ['=' => ['cityName' => 'dubai'], 'LIKE' => ['cityName' => 'old']]], ['tt_cities' => ['cityName']]));
 } catch (Exception $e) {
     var_dump($e->getMessage());
 }

src/GeneratrixCRUD.php

@@ -238,4 +238,95 @@ public static function delete(int $id, array $table, array $callback = []): mysq
             default => $result,
         };
     }
+
+    /**
+     * Handle SEARCH request
+     *
+     * @param array $search
+     * @param array $table
+     * @param array $relationships
+     * @param string $relationshipDirection
+     * @param array $callback
+     * @return array|false|string
+     */
+    public static function search(array $search, array $table, array $relationships = [], string $relationshipDirection = 'LEFT', array $callback = []): bool|array|string
+    {
+        $tableName = array_key_first($table);
+
+        $columnNames = ["$tableName.*"];
+        if ($table[$tableName][0] != '*') {
+            $columnNames = [];
+            foreach ($table[$tableName] as $column) {
+                $columnNames[] = "$tableName.$column";
+            }
+        }
+
+        $columnNames = implode(', ', $columnNames);
+        $sql = "SELECT $columnNames";
+
+        $relatedSql = [];
+        if (count($relationships) > 0) {
+            foreach ($relationships as $key => $value) {
+                $relatedSql[$key] = " JOIN $key";
+
+                $columnNames = ["$key.*"];
+                if ($value[0] != '*') {
+                    $columnNames = [];
+                    foreach ($value as $column) {
+                        $columnNames[] = "$key.$column";
+                    }
+                }
+
+                $columnNames = implode(', ', $columnNames);
+            }
+
+            $sql .= ", $columnNames";
+        }
+
+        $sql .= " FROM $tableName";
+
+        if (count($relatedSql) > 0) {
+            foreach ($relatedSql as $key => $value) {
+                if ($relationshipDirection == 'LEFT') {
+                    $sql .= $value . " ON $tableName." . self::$generatrixDB->dbRelationships[$key]['REFERENCED_COLUMN_NAME'] . " = $key." . self::$generatrixDB->dbRelationships[$key]['COLUMN_NAME'];
+                } else {
+                    $sql .= $value . " ON $tableName." . self::$generatrixDB->dbRelationships[$tableName]['COLUMN_NAME'] . " = $key." . self::$generatrixDB->dbRelationships[$tableName]['REFERENCED_COLUMN_NAME'];
+                }
+            }
+        }
+
+        $sql .= ' WHERE ';
+        $searchesArray = [];
+        foreach ($search as $key => $value) {
+            $searchArray = [];
+            $conditionsOperator = $key;
+            foreach ($value as $k => $v) {
+                if ($k == 'LIKE') {
+                    $searchArray[] = "$tableName." . array_key_first($v) . " $k '%" . $v[array_key_first($v)] . "%'";
+                } else {
+                    $searchArray[] = "$tableName." . array_key_first($v) . " $k '" . $v[array_key_first($v)] . "'";
+                }
+            }
+            $searchesArray[] = '(' . implode(" $conditionsOperator ", $searchArray) . ')';
+        }
+        $sql .= implode(' AND ', $searchesArray);
+
+        $result = self::$generatrixDB->dbConnection->query($sql);
+
+        $response = [];
+        if ($result->num_rows > 0) {
+            while ($row = $result->fetch_assoc()) {
+                $response[] = $row;
+            }
+        }
+
+        if (count($callback) == 2 && is_callable($callback)) {
+            $response = call_user_func_array($callback, $response);
+        }
+
+        return match (self::$responseType) {
+            'JSON' => json_encode($response),
+            default => $response,
+        };
+    }
 }