Skip to content

Getting started

Aimeos uses an advanced architecture that makes it incredible flexible and is also highly optimized for performance and the ability to scale. Thus, it may be different from other software you've used up to now so it's important to understand how things work in Aimeos.


First of all, you should have a look at the different layers within Aimeos and what is their purpose. Also, the dependency injection container (context) is important because you need it almost every time. Both are explained here:


Aimeos is totally customizable without the need to touch any Aimeos code and you should never (!) modify any files in the Aimeos core or the official extesnions! Instead, create your own Aimeos extension for your project where you can store your own classes, templates and configuration. The structure of extensions and how to generate them is described here:

Fetch and store data#

The "MShop" layer using the data access / data transfer object design pattern and consists of managers and items for different data domains (from domain driven design) to interact with the storage like a relational or NoSQL database. They hide the differences between different implementations and offer a single interface for all storage services. Thus, managers allow you to store products in a document oriented storage like ElasticSearch instead of a relational database without any change in your code. How to use managers and items is described here:

Extend managers#

Sometimes, you need to store e.g. additional product data and the first idea might be to extend the product table for that. As said, Aimeos is incredible flexible and allows you to store arbitrary data in property items or attributes. Property items belong to one (product) item only while attributes can be shared between several (product) items. Thus, using properties and attributes, extending the data structures isn't necessary in most cases:

One valid case where you need to extend the data structure (i.e. table or document) is if you need fast filtering and sorting of the (product) items for those values. In that case, you should read:


Become an Aimeos Partner

Aimeos partners are first-class specialists in creating or hosting your Aimeos e-commerce project. They have proven their expertise by building top level e-commerce applications using Aimeos.