popov/php-importer

Universal fast importer tables for different formats, such as Excel or CSV

PHP Importer

Universal importer for different table formats like excel or csv, _(*1)

Installation

Install it with composer, _(*2)

composer require popov/php-importer -o

Supported drivers

1. LibXl (commercial)
2. Excel
3. Soap
4. Csv (not implemented yet)

Requirements

Importer use INSERT ... ON DUPLICATE KEY UPDATE Syntax in background for reduce number of queries to database., _(*3)

You should have only one unique field in your table otherwise you can get undesirable result. If you need to have several unique fields you should group them with UNIQUE Constraint such as UNIQUE (field_1, field_2, ...), _(*4)

Usage

Example import File

Standalone

use Popov\Importer\Factory\DriverCreator;
use Popov\Importer\Importer;
use Popov\Db\Db;

$config = [
    'tasks' => [
        'discount-card' => [
            'driver' => 'libxl',
            'fields' => [
                [
                    // mapping fields in file to db fields with apply filters
                    'Nominal' => ['name' => 'discount', '__filter' => ['percentToInt']],
                    'Serial' => 'serial',

                    // table where save imported data
                    '__table' => 'discount_card',
                    // shortcut name
                    '__codename' => 'discount',
                    // unique field name for avoid duplicate
                    '__identifier' => 'serial'
                ],
            ],
        ],
    ],
];

$pdo = new PDO('mysql:host=myhost;dbname=mydb', 'login', 'password'); 
$db = (new Db())->setPdo($pdo);

$factory = new DriverCreator($config);
$importer = new Importer($factory, $db);

if ($importer->import('discount-card', '/path/to/file.xls')) {
  echo 'Success import!';
} else {
  var_dump($importer->getErrors());
}

Advanced Usage

Most popular PHP frameworks implement IoC pattern and they also implement standard interface Interop\Container\ContainerInterface. This library support this functionality. You can pass your own IoC to Factory and be happy with creating objects., _(*5)

$pdo = new PDO('mysql:host=myhost;dbname=mydb', 'login', 'password'); 
$db = (new Db())->setPdo($pdo);

$container = /* getYourContainer */;
$factory = new DriverCreator($config, $container);
$importer = new Importer($factory, $db);

Configuration

Options marked with * are required., _(*6)

driver *

Driver is handler for data from source. You can use one of the registered drivers or create your own., _(*7)

['driver' => 'Excel']

driver_options

You can pass any custom options to driver, there is no limit for it., _(*8)

Excel options

[
    'driver' => 'Excel',
    "driver_options" => [
        "path" => "data/path/to/excel.xlsx",
        "sheet" => [
            "name" => "Sheet Name",
            "skip" => 2,
        ],
    ],
]

path

Path to file which should be handled., _(*9)

sheet: name

Name of the sheet which should be handled. By default first sheet is taken., _(*10)

sheet: skip

Skip first N rows in file. By default first row is taken., _(*11)

fields

Mapping fields from one resource to new (MySQL, CSV, Excel), _(*12)

The simples mapping can be written as:, _(*13)

// from   =>   to
['Serial' => 'serial']

Fields filtration and preparation can be grouped in chain, _(*14)

[
    'Nominal' => ['name' => 'discount', '__filter' => ['trim', 'percentToInt']]
]

*__filter* - reserved name for filtration, _(*15)

*__prepare* - reserved name for preparation, _(*16)

All reserved options begin with "__" (double underscore)., _(*17)

__table

'__table' => 'table_name',

Required. A table where to save imported data., _(*18)

__codename

'__codename' => 'discount',

Required. Shortcut unique name for config related to table., _(*19)

__identifier

'__identifier' => 'serial',
// or
'__identifier' => ['asin', 'marketplace'],

Unique field name for avoid duplicated items. Identifier can be as one field such as multiple fields., _(*20)

__ignore

'__ignore' => ['comment'],

Fields which should be ignored in save operation. These fields can be used in data filtration., _(*21)

__exclude

'__exclude' => false,

Bool. Exclude table from save operation. All fields can be used in data filtration., _(*22)

__exclude

'__foreign' => ['customer_table' => 'customerId'],

This option is actual if set up minimum two group of fields in config. For example, if you have customer and review info, you put customer info in first group of fields and review info in second group of fields. When first group will be saved the ID will be marked in memory and second group can use this value., _(*23)

Options

mode

'__options' => [
    'mode' => 'save'
]

save - save new and excited data, _(*24)

update - only update excited data, _(*25)

Integration with ZF2

There's a module for that!, _(*26)