PHPackages                             formatd/importer - 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. [API Development](/categories/api)
4. /
5. formatd/importer

ActiveNeos-package[API Development](/categories/api)

formatd/importer
================

This package provides an XML-Importer for Neos Flow entities.

v1.0.0(6y ago)05MITPHP

Since Sep 18Pushed 6y agoCompare

[ Source](https://github.com/Format-D/FormatD.Importer)[ Packagist](https://packagist.org/packages/formatd/importer)[ RSS](/packages/formatd-importer/feed)WikiDiscussions master Synced 2d ago

READMEChangelog (1)Dependencies (1)Versions (2)Used By (0)

FormatD.Importer
================

[](#formatdimporter)

This package provides an XML-Importer for Neos Flow entities.

What does it do?
----------------

[](#what-does-it-do)

This package provides an XML-Importer for Neos Flow entities. By creating an XML following a specific structure you can for example create fixtures for tests or use it to import data and resources into the system for which you do not have a frontend for editing data. You can also import the entities only into memory and choose not to persist them (useful for test fixtures for example).

Running the import
------------------

[](#running-the-import)

Importing a simple file as one-time-import:

```
    ./flow import:xml /path/to/xml-file.xml

```

### Import and updates

[](#import-and-updates)

If you would like to later on update data you have previously imported you can use an optional parameter to inject the UUIDs into the imported XMLs. That way if you change it and import it again the entities are updated and not created again.

```
    ./flow import:xml /path/to/xml-file.xml --enableXmlModification

```

It is possible to reference other entities in the xml by specifying a id. If you have already imported stuff you can load this data into memory so that all references are loaded.

```
    ./flow import:xml /path/to/xml-file.xml --initializePathAndFilename="/path/to/other/files/with"

```

### Using importer for test fixtures

[](#using-importer-for-test-fixtures)

The importer can be used as a convenient way to create fixtures for functional or end-to-end testing.

If you need some data in a functional test you can do something like this:

```

    $importService->setPersistenceEnabled(FALSE);
    $importService->importFromFile('/path/to/file');
    $fixture = $importService->getImportedObjectByReference(My\Package\Domain\Model\ShippingRate:class, 'standard');

```

XML Structure for import files
------------------------------

[](#xml-structure-for-import-files)

### Basic Example

[](#basic-example)

Here is an example of a simple import-file. This creates two shippingRate entities and two timeFrame entities referencing one of the shipping rates.

```

					Standard
					3
					3.90

					Stundengenau
					4
					5.90

					8 - 9 Uhr

							08:00:00

					1
					5

					9 - 10 Uhr

							09:00:00

					1
					5

```

The section `` contains only a mapping what repository is used for which entity. The `` section contains arbitrary named sections such as `` in our example. These Sections themselves contain multiple sections with a `type=""` attribute.

It is possible to split the imported data into multiple files prefixed by a 3 digit number (be aware that the files are sorted before import). You have to take care that referenced entities are already imported before referencing them.

```
    000_MetaData.xml
    010_ShippingRates.xml
    020_TimeFrames.xml

```

### Nesting and Relations

[](#nesting-and-relations)

It is possible to define relations (ManyToMany or OneToMany) in a seperate section ``:

```
...

                TRUE
                Some rule to manage the TimeFrame 8-9
                100
                50

...
```

The importer works recursively and also imports nested structures:

```
...

                ...

                        10 - 11 Uhr

                                10:00:00

                        1
                        5

                                Some other Rate
                                6
                                19.90

...
```

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

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

Unknown

Total

1

Last Release

2430d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/bb327c5b80466d2d0236e188879eb7bfefe44330e56fe7cc27b5417a5b9689ea?d=identicon)[formatd](/maintainers/formatd)

---

Top Contributors

[![bweinzierl](https://avatars.githubusercontent.com/u/30659291?v=4)](https://github.com/bweinzierl "bweinzierl (2 commits)")

### Embed Badge

![Health badge](/badges/formatd-importer/health.svg)

```
[![Health](https://phpackages.com/badges/formatd-importer/health.svg)](https://phpackages.com/packages/formatd-importer)
```

###  Alternatives

[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M272](/packages/twilio-sdk)[flowpack/elasticsearch

This package provides wrapper functionality for the Elasticsearch engine.

34485.9k4](/packages/flowpack-elasticsearch)[wwwision/graphql

Base package to create GraphQL endpoints with Flow

2115.7k1](/packages/wwwision-graphql)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
