import models

Author: aVadim483

.gitignore

@@ -0,0 +1,3 @@
+vendor
+composer.lock
+.phpunit.result.cache

README.md

@@ -4,7 +4,9 @@ Lightweight and very fast XLSX Excel Spreadsheet Writer for Laravel
 
 ## Introduction
 
-This library is a wrapper for avadim/fast-excel-writer, so it's also lightweight, fast, and requires a minimum of memory.
+Exporting data from your Laravel application has never been so fast! Importing models into your Laravel application has never been so easy!
+
+This library is a wrapper for avadim/fast-excel-writer фтв avadim/fast-excel-куфвук, so it's also lightweight, fast, and requires a minimum of memory.
 Using this library, you can export arrays, collections and models to a XLSX-file from your Laravel application.
 
 ## Installation
@@ -80,7 +82,7 @@ $sheet->writeData(function () {
 
 ```
 
-## Advanced usage
+## Advanced usage for data export
 
 See detailed documentation for avadim/fast-excel-laravel here: https://github.com/aVadim483/fast-excel-writer/tree/master#readme
 

composer.json

@@ -7,7 +7,8 @@
         "PHPExcel",
         "spreadsheet",
         "laravel",
-        "export"
+        "export",
+        "import"
     ],
     "type": "library",
     "homepage": "https://github.com/aVadim483/fast-excel-laravel",
@@ -18,10 +19,10 @@
         }
     },
     "require": {
-        "php": "^7.4|^8.1",
+        "php": ">=7.4",
         "ext-json": "*",
-        "avadim/fast-excel-writer": "^4.0",
-        "avadim/fast-excel-reader": "^2.2",
+        "avadim/fast-excel-writer": "^4.1",
+        "avadim/fast-excel-reader": "^2.3",
         "illuminate/support": "^6.0|^7.0|^8.0|^9.0|^10.0",
         "illuminate/contracts": "^6.0|^7.0|^8.0|^9.0|^10.0"
     },

src/FastExcelLaravel/ExcelReader.php

@@ -4,6 +4,11 @@
 
 class ExcelReader extends \avadim\FastExcelReader\Excel
 {
+    public static function createSheet(string $sheetName, $sheetId, $file, $path): SheetReader
+    {
+        return new SheetReader($sheetName, $sheetId, $file, $path);
+    }
+
     /**
      * Open XLSX file
      *
@@ -16,4 +21,17 @@ public static function open(string $file): ExcelReader
         return new self($file);
     }
 
+    /**
+     * @param string $modelClass
+     * @param string|bool|null $address
+     * @param array|bool|null $columns
+     *
+     * @return $this
+     */
+    public function loadModels(string $modelClass, $address = null, $columns = null): ExcelReader
+    {
+        $this->sheet()->loadModels($modelClass, $address, $columns);
+
+        return $this;
+    }
 }

src/FastExcelLaravel/SheetReader.php

@@ -2,13 +2,46 @@
 
 namespace avadim\FastExcelLaravel;
 
+use Illuminate\Database\Eloquent\Model;
+
 class SheetReader extends \avadim\FastExcelReader\Sheet
 {
-    public function loadModel($modelClass, $address = null, $columns = null)
+    /**
+     * Load models from Excel
+     *      loadModels(User::class)
+     *      loadModels(User::class, true) -- the first row used as a field names
+     *      loadModels(User::class, 'B:D') -- read data from columns B:D
+     *      loadModels(User::class, 'B3') -- read data from area started at B3
+     *      loadModels(User::class, 'B3', true) -- read data from area started at B3 and the first row used as a field names
+     *
+     * @param $modelClass
+     * @param $address
+     * @param $columns
+     *
+     * @return $this
+     */
+    public function loadModels($modelClass, $address = null, $columns = null): SheetReader
     {
-        $this->setReadArea($address);
-        foreach ($this->nextRow() as $rowNum => $rowData) {
+        $resultMode = 0;
+        if ($columns === true) {
+            $resultMode = \avadim\FastExcelReader\Excel::KEYS_FIRST_ROW;
+            $columns = [];
+        }
+        elseif ($columns === null && $address === true) {
+            $columns = [];
+            $resultMode = \avadim\FastExcelReader\Excel::KEYS_FIRST_ROW;
+        }
+        if ($address && is_string($address)) {
+            $this->setReadArea($address);
+        }
+        $tz = date_default_timezone_get();
+        foreach ($this->nextRow($columns, $resultMode) as $rowData) {
+            /** @var Model $model */
             $model = new $modelClass;
+            $model->fill($rowData);
+            $model->save();
         }
+
+        return $this;
     }
 }

tests/FakeModel.php

@@ -0,0 +1,40 @@
+<?php
+
+namespace avadim\FastExcelLaravel;
+
+class FakeModel
+{
+    public static array $storage = [];
+
+    protected array $attributes = [];
+    protected array $fillable = [];
+
+    public function __construct(array $attributes = [])
+    {
+        $this->fill($attributes);
+    }
+
+    public static function create(array $attributes = []): FakeModel
+    {
+        return new self($attributes);
+    }
+
+    public function fill(array $attributes): FakeModel
+    {
+        $this->attributes = $attributes;
+
+        return $this;
+    }
+
+    public function save(array $options = []): bool
+    {
+        self::$storage[] = $this;
+
+        return true;
+    }
+
+    public function __get($name)
+    {
+        return $this->attributes[$name] ?? null;
+    }
+}

tests/FastExcelLaravelTest.php

@@ -1,16 +1,14 @@
 <?php
 
-
 declare(strict_types=1);
 
 namespace avadim\FastExcelLaravel;
 
+require_once __DIR__ . '/FakeModel.php';
+
 use Illuminate\Support\Collection;
-use PHPUnit\Framework\TestCase;
 use avadim\FastExcelReader\Excel as ExcelReader;
-use \Illuminate\Filesystem\Filesystem as File;
 
-//final class FastExcelLaravelTest extends TestCase
 final class FastExcelLaravelTest extends \Orchestra\Testbench\TestCase
 {
     protected ?ExcelReader $excelReader = null;
@@ -24,8 +22,26 @@ protected function setUp(): void
         $this->testStorage = __DIR__ . '/test_storage';
 
         app()->useStoragePath($this->testStorage);
+        $this->setUpDatabase();
+    }
+
+    protected function getEnvironmentSetUp($app)
+    {
+        $app['config']->set('database.default', 'sqlite');
+        $app['config']->set('database.connections.sqlite', [
+            'driver' => 'sqlite',
+            'database' => ':memory:',
+            'prefix' => '',
+        ]);
     }
 
+    protected function setUpDatabase()
+    {
+        //$res = $this->artisan('migrate')->run();
+        //$this->loadMigrationsFrom(__DIR__ . '/../database/migrations/000_create_test_models_table.php');
+    }
+
+
     protected function getValue($cell)
     {
         preg_match('/^(\w+)(\d+)$/', strtoupper($cell), $m);
@@ -292,4 +308,42 @@ public function testAdvanced()
         $this->endTest($testFileName);
     }
 
+    public function testLoadModel()
+    {
+        $testFileName = 'test_model.xlsx';
+        $excel = Excel::open(storage_path($testFileName));
+        $this->assertEquals('Sheet1', $excel->sheet()->name());
+
+        FakeModel::$storage = [];
+        $excel->loadModels(FakeModel::class);
+        $this->assertCount(4, FakeModel::$storage);
+        $this->assertNull(FakeModel::$storage[0]->name);
+
+        FakeModel::$storage = [];
+        $excel->loadModels(FakeModel::class, true);
+        $this->assertCount(3, FakeModel::$storage);
+        $this->assertEquals('James Bond', FakeModel::$storage[0]->name);
+
+        FakeModel::$storage = [];
+        $excel->loadModels(FakeModel::class, 'b2');
+        $this->assertCount(3, FakeModel::$storage);
+        $this->assertNull(FakeModel::$storage[0]->name);
+
+        FakeModel::$storage = [];
+        $excel->loadModels(FakeModel::class, 'b1', true);
+        $this->assertCount(3, FakeModel::$storage);
+        $this->assertEquals('James Bond', FakeModel::$storage[0]->name);
+
+        FakeModel::$storage = [];
+        $excel->setDateFormat('Y-m-d');
+        $excel->loadModels(FakeModel::class, 'c4', ['B' => 'foo', 'C' => 'bar', 'D' => 'int']);
+        $this->assertEquals('1753-01-31', FakeModel::$storage[0]->bar);
+
+        FakeModel::$storage = [];
+        $excel->loadModels(FakeModel::class, 'b2', ['B' => 'foo', 'C' => 'bar', 'D' => 'int']);
+        $this->assertCount(3, FakeModel::$storage);
+        $this->assertEquals('Captain Jack Sparrow', FakeModel::$storage[2]->foo);
+        $this->assertEquals('1753-01-31', FakeModel::$storage[2]->bar);
+        $this->assertEquals(7239, FakeModel::$storage[2]->int);
+    }
 }