4 min. read
Categories: Ecosystem
How to start your career as a Sylius developer 👨‍💻

Sylius is an open-source eCommerce framework based on PHP Symfony. It is available in two versions: a Community Edition and a commercial edition – Sylius Plus. Both options give the ability to scale and expand the eCommerce store with ease.

Sylius is an API-first, headless, PWA-ready open-source platform suitable for numerous cases for merchants who value digitalizing businesses. Sylius stands in contrast to the monolithic approach, and its superior performance has drawn many major players in the eCommerce industry. Its adaptability, exceptional architecture, and underlying philosophy provide enough flexibility to describe it as both a platform and a framework for even the most complex eCommerce initiatives.

This article is aimed at software developers who want to learn how to become outstanding Sylius developer. It will also be handy to those who want to learn good practices while working on projects based on Symfony and freelancers who want to learn the foundations of working with Sylius.  

Important information for a future Sylius developer

First, it’s beneficial to have some familiarity with Symfony; however, knowledge of PHP (and the so-called LAMP or similar stack) is essential. There are numerous tutorials available for learning both, but this article will bypass them and presume that readers are either currently proficient or will soon be fluent in these technologies. We suggest exploring SymfonyCasts, which offers a wealth of videos on PHP, design patterns used in the language, and the Symfony framework itself. While it’s possible to learn these aspects from documentation and StackOverflow, SymfonyCasts provides a well-organized and easily digestible step-by-step approach to the material, making it a valuable investment.

  • Firstly, anyone new to Sylius should allocate time to grasp its architecture and foundational elements – for example, mastering the ResourceBundle, GridBundle, and CoreBundle is crucial for navigating and learning the system effectively.
  • Secondly, the Sylius documentation offers a lot of valuable information and practical examples that cover not just the contents of the package but also how to utilize them with ease. It includes detailed descriptions of the installation and customization processes that are worthwhile. However, for a complete understanding, diving into the code is recommended. Always ensure you’re familiar with the latest version of the documentation. Going through the documentation and the mechanics of Sylius should take no more than a few hours or days, depending on your learning pace.
  • Thirdly, once you’ve familiarized yourself with the documentation and feel prepared to start practical work, it’s time to install Sylius in your local environment. Initially, you might frequently refer back to the documentation, but you’ll quickly learn what information is available and where to find it. Despite the quality of the documentation, some questions might still arise. There are two ways to address these. One approach is to debug the code’s execution and examine the vendor’s code, which is quite straightforward, especially if you use Xdebug with your IDE—a highly recommended practice. Alternatively, you can join the official Sylius community on Slack and directly ask any of the 6,500 members who may have encountered similar issues. The Sylius community is incredibly helpful, and typically, you’ll receive a swift response. We’re active there as well! More on the community will be discussed later in this article.

Standardization in Sylius projects

When dealing with standardization, adhering to the Sylius coding standards simplifies navigation throughout the project. As Sylius is built on Symfony, it adopts its conventions while introducing additional ones, such as static code analysis using PHPStan.

The goal of standardization is to make management and project transitions smoother and to enhance the implementation process. Additionally, it minimizes potential misunderstandings among developers by utilizing clear coding rules that must be followed. Embracing this approach is particularly important for those who aim to be effective team members and think about the project’s long-term success. This mindset is indeed a valuable asset for any proficient developer.

Key elements in Sylius

The state machine is a fundamental concept in Sylius, utilized extensively across various processes, such as the checkout process and the handling of an order’s shipments and payments. To implement this, Sylius uses the WinzouStateMachineBundle, which serves as an integration layer between the state machine library and Symfony, both of which are provided by the same vendor. Initially, this might seem complex, but its value becomes clear once you fully understand its purpose and see how Sylius applies it. Take our word for it – it’s a powerful tool.


Many web applications often feature a grid with options for sorting and filtering. This bundle facilitates the display of grids by incorporating the Sylius Grid component into the Symfony framework, for example, enabling automatic sorting. A crucial element of this setup is mastering the ResourceBundle, which standardizes CRUD operations and forms the foundation of many aspects of Sylius.

Database structure

To keep it simple, knowing where to find the information you need in Sylius is essential. It’s advisable to read Sylius’ documentation to learn how to extend data structure by adding new fields and relationships to the database and specific segments of the data architecture, such as creating and customizing repositories for a proper access layer.

API Platform

API Platform is a REST and GraphQL framework that is designed to build modern API-driven projects, which are, in fact, a norm in the Symfony world nowadays. For instance, the API Platform covers functionalities like product catalog and checkout. To understand fully what the API offers in Sylius, feel free to explore the demo.

To learn how to utilize the Sylius API effectively, it is worth to study the Cookbook. This resource provides a broad overview of conducting various operations within Sylius, making it an extremely valuable tool for navigating the Sylius ecosystem.

Join Sylius Community!

The Slack channel dedicated to Sylius developers is the first resource that is certainly worth exploring. Beyond the Sylius documentation, it is an excellent forum for interacting with the community, whether you need assistance with an issue or wish to offer help. Additionally, you might want to visit Friends of Sylius on GitHub, which hosts numerous open-source plugins, bundles, tutorials, and more. Packagist also features a repository for Sylius packages. BitBag’s GitHub is another good source for numerous Sylius plugins, and their blog offers even more valuable content.

Lastly, once you gain some understanding of Sylius and the Symfony framework, it’s highly beneficial to engage in helping others. Teaching not only aids in learning but also promotes personal and professional development.


Sylius is a platform that offers extensive capabilities, superior performance, and high-quality code. Proficiency in PHP Symfony can greatly enhance a software developer’s career, opening doors to opportunities as a Sylius developer. Furthermore, the Sylius community is always ready to help and support newcomers. As a team, the Sylius community encourages sharing your expertise with others; therefore, do not hesitate to spread the word by sharing this article!

Originally published at https://bitbag.io on March 23, 2023

Tags: Sylius
Patryk Baczewski
More from our blog
Cloud 4 min read 17.06.2024
We are thrilled to announce that we just signed a strategic partnership with Platform.sh, and as a result, we are extending our offer with Sylius Cloud powered by Platform.sh. Platform.sh is a modern Platform-as-a-Service (PaaS) solution that allows businesses to leverage the cloud environment without losing access to the code… Read More
Technical 4 min read 11.06.2024
Abstract 1.12 released in Q4 2022 1.13 on Apr 23rd, 2024 (a year later than we anticipated while releasing 1.12) 3859 commits 23 contributors A stabilized Sylius API powered by API Platform It’s been a long and bumpy road. Having it behind our backs was a highway that led Sylius… Read More
Business Ecosystem News 4 min read 06.06.2024
Welcome to the May summary! As an open-source eCommerce framework, Sylius continues to evolve with significant contributions from our vibrant community and valuable product updates. Apart from describing the technical changes, we will also quickly summarize the Sylius Technical Fundamentals & Sylius Polish Community Meetup and eCommerce Day Kaunas, as… Read More