You are reading the documentation for version 2.2. Magento 2.3 is the latest version available. Ensure you are reading the documentation for your version of Magento.

Architectural layers overview

Magento as layered software

At its highest level, Magento’s product architecture consists of the core product code plus optional modules. These optional modules enhance or replace the basic product code.

If you are substantially customizing the basic Magento product, module development will be your central focus. Modules organize code that supports a particular task or feature. A module can include code to change the look-and-feel of your storefront as well as its fundamental behavior.

Your modules function with the core Magento product code, which is organized into layers. Understanding layered software pattern is essential for understanding basic Magento product organization.

Layered software is a popular, widely discussed principle in software development. Many resources exist for this topic, but consider consulting Pattern-Oriented Software Architecture for a general discussion.

Advantages of layered application design

Layered application design offers many advantages, but users of Magento will appreciate:

  • Stringent separation of business logic from presentation logic simplifies the customization process. For example, you can alter your storefront appearance without affecting any of the backend business logic.

  • Clear organization of code predictably points extension developers to code location.

Related topics

Architectural diagrams

Presentation layer

Service layer

Domain layer

Persistence layer