PHPackages                             adrec/backpack-import - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [PDF & Document Generation](/categories/documents)
4. /
5. adrec/backpack-import

ActiveLibrary[PDF & Document Generation](/categories/documents)

adrec/backpack-import
=====================

Import Operation for Laravel Backpack CRUD - supports CSV and Excel file imports

v1.0.0(3mo ago)01MITPHPPHP ^8.2

Since Jan 30Pushed 3mo agoCompare

[ Source](https://github.com/adrecdevoutlook/backpack-import)[ Packagist](https://packagist.org/packages/adrec/backpack-import)[ RSS](/packages/adrec-backpack-import/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (2)Versions (2)Used By (0)

Adrec Backpack Import
=====================

[](#adrec-backpack-import)

Import Operation for [Laravel Backpack](https://backpackforlaravel.com/) CRUD — supports CSV and Excel file imports with a 3-step wizard UI.

**Compatible with:** Laravel 12+, Backpack CRUD 7+, PHP 8.2+

Features
--------

[](#features)

- 3-step import wizard: **Upload → Map Columns → Confirm & Execute**
- Supports **CSV**, **XLS**, **XLSX** file formats
- Column type handlers: Text, Number, Boolean, Date, Array
- Auto-detect column mapping by header name
- Row-level validation using CRUD form request rules
- **Update or Create** — matches existing records by primary key
- Sync or **Queue-based** background processing
- Import history tracking via `import_logs` table
- Event hooks for custom logic (Started, RowProcessed, RowSkipped, Complete)
- Template file download support

Requirements
------------

[](#requirements)

- PHP >= 8.2
- Laravel >= 12.0
- Backpack CRUD >= 7.0
- maatwebsite/excel

Installation
------------

[](#installation)

### Option 1: Local package (development)

[](#option-1-local-package-development)

Add the repository and require the package in your project's `composer.json`:

```
{
    "require": {
        "adrec/backpack-import": "@dev"
    },
    "repositories": {
        "adrec-backpack-import": {
            "type": "path",
            "url": "packages/adrec/backpack-import"
        }
    }
}
```

Then run:

```
composer update adrec/backpack-import
```

### Option 2: Via Composer (when published)

[](#option-2-via-composer-when-published)

```
composer require adrec/backpack-import
```

### Run Migration

[](#run-migration)

```
php artisan migrate
```

### Publish Config (optional)

[](#publish-config-optional)

```
php artisan vendor:publish --tag=backpack-import-config
```

### Publish Views (optional)

[](#publish-views-optional)

```
php artisan vendor:publish --tag=backpack-import-views
```

Usage
-----

[](#usage)

### Basic Usage

[](#basic-usage)

Add the `ImportOperation` trait to your CrudController:

```