1. Giới thiệu
Bài viết trước mình đã chia sẻ cho mọi người cách export file excel trong Laravel
. Hôm nay mình sẽ tiếp tục chia sẻ cho mọi người cách import file excel.
2. Cài đặt
2.1. Cài đặt package
Đầu tiên muốn sử dụng được thì các bạn cần cài package maatwebsite/excel
bằng composer
như sau:
composer require maatwebsite/excel
2.2. Tùy chỉnh cấu hình excel
Để làm được điều này các bạn cần chạy
php artisan vendor:publish --provider="Maatwebsite\Excel\ExcelServiceProvider"
Lệnh này có tác dụng copy file config của maatwebsite/excel
ra bên ngoài. File mới sẽ có tên là config/excel
3. Import bằng maatwebsite/excel
Đầu tiên các bạn cần chạy câu lệnh artisan
để tạo ra một file export
php artisan make:import UserImport
Một file import sẽ được tạo ra. Nó sẽ trông như thế này
class UserImport implements ToModel
{ public function model(array $row) { return new User([ // ]); }
}
maatwebsite/excel
hỗ trợ sẵn chúng ta một số function để chúng ta có thể dễ dàng thực thi về logic hay về hiện thị như một số function sau đây:
3.1. function model()
Đúng với tên gọi của nó, function này có chức năng để thao tác với DB để thay đổi dữ liệu.
$rm = User::where('email', $row['email'])->first(); if ($rm) { $rm->update($row); } else { $password = Str::random(8); $row['password'] = Hash::make($password); $rm = User::create($attributes); }
Đoạn code trên sẽ thực thi như sau. Nếu mà data import trong file excel trùng email thì mình sẽ cập nhật các trường còn lại. Còn không sẽ cập nhật data.
3.2. function map()
Một function khác cũng khá là quan trọng là map()
. Function này sẽ giúp ta mapping dữ liệu trong file excel
public function map($row): array { return [ 'name' => trim($row[self::FIRST_NAME]), //index=0 'email' => trim($row[self::EMAIL]), //index=1 'status' => trim($row[self::STATUS]), //index=2 ]; }
Để sử dụng function này cần implements interface Maatwebsite\Excel\Concerns\WithMapping
3.3. function startRow()
function này sẽ giúp ta biết nên đọc dữ liệu từ hàng nào. Trong một số file có heading việc sử dụng function này là cần thiết. Để sử dụng ta cần implements interface Maatwebsite\Excel\Concerns\WithStartRow
.
public function startRow(): int { return config('excel.imports.start_row'); // return 2; }
3.4. function rules()
- Có một câu nói rằng " Đừng bao giờ tin vào người dùng". Vì thế trong mọi trường hợp chúng ta cần validate dữ liệu. function rules validate dữ liệu đầu vào giúp ngăn chặn lỗi xảy ra. Để sử dụng chúng ta cần implements interface
Maatwebsite\Excel\Concerns\WithValidation
public function rules(): array { return [ 'name' => [ 'bail', 'required', 'string', 'max:'.'50', ], 'email' => [ 'bail', 'required', 'max:'.config('validation.maxlength_input'), 'email', new EmailRule(), ], 'tel' => [ 'bail', 'required', 'max:'.config('validation.maxlength_input'), ], ]; }
4. Tạo routes
Chúng ra cần tạo 2 routes để hiện thị và import file
Route::get('/import', '_@.com');
Route::post('/import', '_@.com')->name('import');
5. Tạo template
Ở đây mình chỉ tạo một template đơn giản thực hiện cho việc gửi file như sau:
<form action="{{ route('import') }}" method="post" enctype="multipart/form-data"> @csrf <input type="file" name="file_user" id="file_user"> <button type="submit">Submit</button>
</form>
6. Tạo controller
Mỗi khi thao tác với dữ liệu chúng ta cần tạo controller. Ở đây mình sẽ tạo một controller như sau:
php artisan make:controller ImportUserController
Controller sẽ chứa các fucntion như sau
6.1. __construct()
//Hàm này sẽ inject hàm UserImport mà chúng ta vừa tạo
use App\Imports\UserImport;
public function __construct(UserImport $userImport) { $this->userImport = $userImport; }
6.2. importBlade()
//function này sẽ hiển thị blade view
public function importBlade() { return view('admin.Import.import'); }
6.3. import()
//function này sẽ thực thi import
public function import(Request $request) { try { $this->userImport->import($request->file('file_user')); } catch (\Exception $e) { report($e); } }
7. Kết luận
Hi vọng bài viết này sẽ giúp ích được cho các bạn. Nếu có thắc mắc hay câu hỏi gì đừng ngần ngại comment dưới post này nha. Ngoài ra các bạn có thể tham khảo post mình viết về import excel Laravel. Cám ơn các bạn ? https://viblo.asia/p/cach-export-data-ra-file-excel-trong-laravel-Eb85ozX6l2G