add file interface

add file helpers
add function batch()

Author: mavinoo

README.md

@@ -6,6 +6,7 @@ Insert and update batch (bulk) in laravel
 [![Total Downloads](https://poser.pugx.org/mavinoo/laravel-batch/downloads)](https://packagist.org/packages/mavinoo/laravel-batch)
 [![Daily Downloads](https://poser.pugx.org/mavinoo/laravel-batch/d/daily)](https://packagist.org/packages/mavinoo/laravel-batch)
 
+
 # Install
 `composer require mavinoo/laravel-batch`
 
@@ -19,7 +20,6 @@ file app.php in array aliases :
 
 `'Batch' => Mavinoo\LaravelBatch\LaravelBatchFacade::class,`
 
-
 # Example Update 1
 
 ```php
@@ -115,6 +115,7 @@ $batchSize = 500; // insert 500 (default), 100 minimum rows in one query
 $result = Batch::insert($userInstance, $columns, $values, $batchSize);
 ```
 
+
 ```php
 // result : false or array
 
@@ -126,3 +127,18 @@ Array
     [totalQuery] => 1
 )
 ```
+
+
+
+# Helper batch()
+
+```php
+// ex: update
+
+$result = batch()->update($userInstance, $value, $index);
+
+
+// ex: insert
+
+$result = batch()->insert($userInstance, $columns, $values, $batchSize);
+```

composer.json

@@ -13,7 +13,10 @@
     "autoload": {
         "psr-4": {
             "Mavinoo\\LaravelBatch\\": "src/"
-        }
+        },
+        "files": [
+            "src/Common/Helpers.php"
+        ]
     },
     "extra": {
         "laravel": {

src/Common/Common.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace Mavinoo\LaravelBatch\Common;
+
+class Common
+{
+    public static function mysql_escape($inp)
+    {
+        if(is_array($inp)) return array_map(__METHOD__, $inp);
+
+        if(!empty($inp) && is_string($inp))
+        {
+            return str_replace(
+                ['\\', "\0", "\n", "\r", "'", '"', "\x1a"],
+                ['\\\\', '\\0', '\\n', '\\r', "\\'", '\\"', '\\Z'],
+                $inp);
+        }
+
+        return $inp;
+    }
+}

src/Common/Helpers.php

@@ -1,21 +1,9 @@
-<?php
-
-namespace Mavinoo\LaravelBatch\Common;
-
-class Helpers
-{
-    public static function mysql_escape($inp)
-    {
-        if(is_array($inp)) return array_map(__METHOD__, $inp);
-
-        if(!empty($inp) && is_string($inp))
-        {
-            return str_replace(
-                ['\\', "\0", "\n", "\r", "'", '"', "\x1a"],
-                ['\\\\', '\\0', '\\n', '\\r', "\\'", '\\"', '\\Z'],
-                $inp);
-        }
-
-        return $inp;
-    }
-}
+<?php
+
+if (! function_exists('batch'))
+{
+    function batch()
+    {
+        return app('Mavinoo\LaravelBatch\Batch');
+    }
+}

src/InterfaceBatch.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace Mavinoo\LaravelBatch;
+
+use Illuminate\Database\Eloquent\Model;
+
+interface InterfaceBatch
+{
+    public function update(Model $table, array $values, string $index = null);
+
+    public function insert(Model $table, array $columns, array $values, int $batchSize = 500);
+}

src/LaravelBatch.php

@@ -4,9 +4,9 @@
 
 use Illuminate\Database\DatabaseManager;
 use Illuminate\Database\Eloquent\Model;
-use Mavinoo\LaravelBatch\Common\Helpers;
+use Mavinoo\LaravelBatch\Common\Common;
 
-class Batch
+class Batch implements InterfaceBatch
 {
     /**
      * @var DatabaseManager
@@ -61,7 +61,7 @@ public function update(Model $table, array $values, string $index = null)
             $ids[] = $val[$index];
             foreach (array_keys($val) as $field) {
                 if ($field !== $index) {
-                    $value = (is_null($val[$field]) ? 'NULL' : '"' . Helpers::mysql_escape($val[$field]) . '"');
+                    $value = (is_null($val[$field]) ? 'NULL' : '"' . Common::mysql_escape($val[$field]) . '"');
                     $final[$field][] = 'WHEN `' . $index . '` = "' . $val[$index] . '" THEN ' . $value . ' ';
                 }
             }
@@ -143,14 +143,14 @@ public function insert(Model $table, array $columns, array $values, int $batchSi
         $values = array_chunk($values, $totalChunk, true);
 
         foreach ($columns as $key => $column) {
-            $columns[$key] = "`" . Helpers::mysql_escape($column) . "`";
+            $columns[$key] = "`" . Common::mysql_escape($column) . "`";
         }
 
         foreach ($values as $value) {
             $valueArray = [];
             foreach ($value as $data) {
                 foreach ($data as $key => $item) {
-                    $item = is_null($item) ? 'NULL' : "'" . Helpers::mysql_escape($item) . "'";
+                    $item = is_null($item) ? 'NULL' : "'" . Common::mysql_escape($item) . "'";
                     $data[$key] = $item;
                 }