PHPackages sylius/import-export-bundle - 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. [Utility & Helpers](/categories/utility) 4. / 5. sylius/import-export-bundle ActiveSymfony-bundle[Utility & Helpers](/categories/utility) sylius/import-export-bundle =========================== The ImportExportBundle allows for easy and decoupled data migration to and from various mediums v0.2.1(3mo ago)5919↓16.7%3[2 issues](https://github.com/Sylius/ImportExportBundle/issues)[1 PRs](https://github.com/Sylius/ImportExportBundle/pulls)proprietaryPHPPHP ^8.2CI passing Since Jul 23Pushed 3mo agoCompare [ Source](https://github.com/Sylius/ImportExportBundle)[ Packagist](https://packagist.org/packages/sylius/import-export-bundle)[ GitHub Sponsors](https://github.com/sylius)[ RSS](/packages/sylius-import-export-bundle/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (3)Dependencies (18)Versions (4)Used By (0) [ ![Sylius Logo.](https://camo.githubusercontent.com/ea9dddc934264aa7ec01cf3202c500f3d8b04448bce2571bdc74230efddda88f/68747470733a2f2f6d656469612e73796c6975732e636f6d2f73796c6975732d6c6f676f2d3830302e706e67) ](https://sylius.com) Import/Export Bundle ==================== [](#importexport-bundle) The ImportExportBundle allows for easy and decoupled data migration to and from various mediums. It works by relying on the Sylius [Resource](https://github.com/sylius/syliusresourcebundle) and [Grid](https://github.com/Sylius/syliusgridbundle) systems for resolving and providing data. Features -------- [](#features) - **Export**: Generate data exports in JSON/CSV formats with grid actions - **Import**: Import data from JSON files with validation and error handling - **Process Management**: Track import/export processes with status monitoring - **Validation**: Configurable validation groups for import data - **Async Processing**: Background processing via Symfony Messenger (configurable) Export ------ [](#export) ### Functionality [](#functionality) The main and bulk grid actions get automatically injected into configured resources' grids. Supported formats: - json - csv #### Main export action [](#main-export-action) It respects currently applied filters when exporting resources. [![Screenshot showing order grid with main action focused](docs/images/screenshot_order_main_action.png)](docs/images/screenshot_order_main_action.png) #### Bulk export action [](#bulk-export-action) In cases when specifying filters is not enough, or you want just a subset of the resource, in comes the bulk action. [![Screenshot showing order grid with bulk action focused](docs/images/screenshot_order_bulk_action.png)](docs/images/screenshot_order_bulk_action.png) #### Processes [](#processes) Here you can manage currently running and already processed exports as well as download the exported data. [![Screenshot showing processes index](docs/images/screenshot_process_index.png)](docs/images/screenshot_process_index.png) Import ------ [](#import) ### Functionality [](#functionality-1) The import feature provides a user-friendly way to import data from JSON files directly through the admin interface. Supported formats: - json (with plans for additional formats) #### Main import action [](#main-import-action) Import actions are automatically injected into configured resources' grids, allowing administrators to upload and import data files. #### Import Process [](#import-process) 1. **File Upload**: Upload JSON files through the admin interface 2. **Validation**: Data is validated using configurable validation groups 3. **Processing**: Import runs via Symfony Messenger (synchronously by default, can be configured for async) 4. **Status Tracking**: Monitor import progress and view results 5. **Error Handling**: Failed imports are tracked with detailed error messages #### Validation [](#validation) The import system supports configurable validation groups to ensure data integrity: - **Default validation**: Uses entity validation constraints - **Custom validation groups**: Configure specific validation rules per resource - **Error reporting**: Detailed validation error messages for troubleshooting #### Process Management [](#process-management) Import processes are tracked with the following statuses: - `processing`: Import is currently running - `success`: Import completed successfully - `failed`: Import failed with error details Installation ------------ [](#installation) #### Beware! [](#beware) This installation instruction assumes that you're using Symfony Flex. If you don't, take a look at the [legacy installation instruction](docs/legacy_installation.md). However, we strongly encourage you to use Symfony Flex, it's much quicker! 1. Require plugin with composer: ``` composer require sylius/import-export-bundle ``` > Remember to allow community recipes with `composer config extra.symfony.allow-contrib true` or during plugin installation process 2. Apply migrations to your database: ``` bin/console doctrine:migrations:migrate ``` 3. Configure export and import for resources: ``` # config/packages/sylius_import_export.yaml imports: - { resource: "@SyliusImportExportBundle/config/config.yaml" } sylius_import_export: export: resources: sylius.order: ~ app.brand: serialization_groups: ['app:brand:export'] sections: - 'Sylius\Bundle\AdminBundle\SectionResolver\AdminSection' provider: 'sylius_import_export.provider.resource_data.orm' import: resources: sylius.order: ~ app.brand: validation_groups: ['Default', 'import'] ``` For a more detailed overview check the [configuration reference](docs/configuration_reference.md). 4. Configure routes: ``` # config/routes/sylius_import_export.yaml imports: resource: "@SyliusImportExportBundle/config/routes.yaml" ``` File Storage ------------ [](#file-storage) ### Export Files [](#export-files) By default, when a resource gets exported, a file is saved on the server. The save directory is specified with the `%sylius_import_export.export_files_directory%` parameter, that can be overridden if needed. ### Import Files [](#import-files) Import files are temporarily stored on the server during processing. The save directory is specified with the `%sylius_import_export.import_files_directory%` parameter, that can be overridden if needed. Both file directories can be configured: ``` # config/packages/sylius_import_export.yaml sylius_import_export: export: files_directory: '%kernel.project_dir%/var/export' import: files_directory: '%kernel.project_dir%/var/import' file_max_size: '50M' allowed_mime_types: ['application/json'] ``` **Note**: Large file uploads may require adjusting PHP configuration: ``` # php.ini upload_max_filesize = 50M post_max_size = 50M ``` Security issues --------------- [](#security-issues) If you think that you have found a security issue, please do not use the issue tracker and do not post it publicly. Instead, all security issues must be sent to `security@sylius.com`. ### Health Score 41 — FairBetter than 89% of packages Maintenance72 Regular maintenance activity Popularity26 Limited adoption so far Community16 Small or concentrated contributor base Maturity41 Maturing project, gaining track record Bus Factor2 2 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~94 days Total 3 Last Release 110d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/719423?v=4)[Sylius eCommerce](/maintainers/sylius)[@Sylius](https://github.com/Sylius) ![](https://www.gravatar.com/avatar/4b4a5a1a9293502aa8573551fab020963a9050c5cca4524433b6d94214d3b480?d=identicon)[GSadee](/maintainers/GSadee) ![](https://www.gravatar.com/avatar/8f69a17d8172c4e9b9a961305872e04bd44e47b9ed76459125482de8d6ce7ddb?d=identicon)[mpysiak](/maintainers/mpysiak) --- Top Contributors [![mpysiak](https://avatars.githubusercontent.com/u/39049059?v=4)](https://github.com/mpysiak "mpysiak (37 commits)")[![NoResponseMate](https://avatars.githubusercontent.com/u/9448101?v=4)](https://github.com/NoResponseMate "NoResponseMate (31 commits)")[![disstudio](https://avatars.githubusercontent.com/u/26650457?v=4)](https://github.com/disstudio "disstudio (5 commits)")[![Rafikooo](https://avatars.githubusercontent.com/u/40125720?v=4)](https://github.com/Rafikooo "Rafikooo (3 commits)")[![GSadee](https://avatars.githubusercontent.com/u/6140884?v=4)](https://github.com/GSadee "GSadee (2 commits)")[![TheMilek](https://avatars.githubusercontent.com/u/53942444?v=4)](https://github.com/TheMilek "TheMilek (1 commits)") ### Code Quality TestsPHPUnit Static AnalysisPHPStan Type Coverage Yes ### Embed Badge ![Health badge](/badges/sylius-import-export-bundle/health.svg) ``` [![Health](https://phpackages.com/badges/sylius-import-export-bundle/health.svg)](https://phpackages.com/packages/sylius-import-export-bundle) ``` ### Alternatives [sylius/sylius E-Commerce platform for PHP, based on Symfony framework. 8.4k5.6M651](/packages/sylius-sylius)[sulu/sulu Core framework that implements the functionality of the Sulu content management system 1.3k1.3M152](/packages/sulu-sulu)[prestashop/prestashop PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers. 9.0k15.4k](/packages/prestashop-prestashop)[open-dxp/opendxp Content & Product Management Framework (CMS/PIM) 7310.3k29](/packages/open-dxp-opendxp)[contao/core-bundle Contao Open Source CMS 1231.6M2.4k](/packages/contao-core-bundle)[codefog/contao-haste haste extension for Contao Open Source CMS 42650.8k139](/packages/codefog-contao-haste) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)