Architectural Drivers

Architectural Drivers are the key factors that influence all the decisions we take during the application development. Historically, a lot of them were taken unconsciously, but, happily, resulted in good decisions that we can undoubtedly justify today. All of them have a significant influence on the Sylius as an application - they can and should be used to guide us during the development, to take the best decision for the product.

Technical constraints

Programming language


Due to the decision to base Sylius on the Symfony framework (see below), PHP was the only possible option as a programming language. Nevertheless, a good decision! This language is dynamically developing for the last few years and still power up most of the websites and application in the world wide web.

Currently supported PHP versions can be seen in this chapter.

Main frameworks and libraries

Fullstack Symfony


Sylius is based on Symfony, which is a leading PHP framework to create web applications. Using Symfony allows developers to work better and faster by providing them with certainty of developing an application that is fully compatible with the business rules, that is structured, maintainable and upgradable. Also it allows to save time by providing generic re-usable modules.

Learn more about Symfony.



Sylius, by default, uses the Doctrine ORM for managing all entities. Doctrine is a family of PHP libraries focused on providing data persistence layer. The most important are the object-relational mapper (ORM) and the database abstraction layer (DBAL). One of Doctrine’s key features is the possibility to write database queries in Doctrine Query Language (DQL) - an object-oriented dialect of SQL.

For deeper understanding of how Doctrine works, please refer to the excellent documentation on their official website.



Twig is a modern template engine for PHP that is really fast, secure and flexible. Twig is being used by Symfony.

To read more about Twig, go here.

API Platform


API Platform is a modern solution for developing high quality APIs. API Platform works by default with Symfony and depends on its components.

Third Party Libraries

Sylius uses a lot of libraries for various tasks:

  • Payum for payments
  • KnpMenu - for shop and admin menus
  • Flysystem for filesystem abstraction (store images locally, Amazon S3 or external server)
  • Imagine for images processing, generating thumbnails and cropping
  • Pagerfanta for pagination
  • Winzou State Machine - for the state machines handling

Functional requirements

All of the functionality provided by default with Sylius is described as user stories using Behat scenarios. Take a look here to browse them.

Quality attributes

Sylius focuses a lot on the software quality since its very beginning. We use test-driven methodologies like TDD and BDD to ensure reliability of the provided functionalities. Moreover, as Sylius is not the end-project (it rarely used in a vanilla version), but serves as the base for the actual applications, it’s crucial to take care about its ability to fulfill such a role.


Sylius offers a lot of standard e-commerce features, that could and should be used as a base to introduce more advanced and business-specific functionalities.

Question to be asked: is it possible to easily add new, more advanced functionality to the module/class/service I implement? Examples:


Seemingly similar to the previous one, but essentially different. Focuses on making it possible to override the standard functionality with a different one, while still keeping the whole process working. The most important (but not the only) steps to reach it is using interfaces with small, focused and granular services. Customizability should be kept on all levels - from the single service, to the whole module/component.

Question to be asked: is it possible to replace this functionality and do not break the whole process? Examples:


As mentioned before, Sylius embraces test-driven methodologies from its very beginning. Therefore, every class (with some exceptions) should be described with unit tests, every functionality should be designed through Behat acceptance scenarios. Highly tested code is crucial to ensure other, also important driver, which is reliability of the software.

Question to be asked: is my module/class easy to be tested, to protect it from the potential regression?

As history has shown, if something is difficult to be tested, there is a huge chance it’s not designed or written properly.

Sources and inspirations

This chapter was created inspired by the following sources: