Important

You are browsing documentation for version 5.1 of OroCommerce, supported until March 2026. Read the documentation for version 6.0 (the latest LTS version) to get up-to-date information.

See our Release Process documentation for more information on the currently supported and upcoming releases.

Differences to Common Symfony Applications 

Starting your first project using OroPlatform will be easy if you’re familiar with building Symfony applications from scratch. However, there are some differences you need to understand to develop your application efficiently.

This article will give you a short overview of how OroPlatform differs from typical Symfony applications. Each section will link to other resources where you can learn more about a particular feature.

The Application Kernel 

In Symfony applications, you register your and all the third-party bundles from the vendor directory in the AppKernel class. This is unnecessary when using OroPlatform. It comes with its own kernel that discovers bundles under the src and the vendor directories automatically if they contain a bundles.yml configuration file in their Resources/config/oro directory.

This file must contain a list of bundle classes to initialize under the bundles key. Usually, it is only a one class name:

src/Acme/Bundle/DemoBundle/Resources/config/oro/bundles.yml 
 bundles:
     - Acme\Bundle\DemoBundle\AcmeDemoBundle

Optionally, you can specify a priority. The priority defines the order in which bundles will be loaded. If you omit the priority, its value will implicitly be 0:

src/Acme/Bundle/DemoBundle/Resources/config/oro/bundles.yml 
 bundles:
     - { name: Acme\Bundle\DemoBundle\AcmeDemoBundle, priority: 10 }

Caution

A higher priority does not mean that one bundle is loaded before another bundle with a lower priority. Instead, lower prioritized bundles are loaded first.

Tip

The default priority for all bundles is 0.

Routing Configuration 

You can configure routes for your controller actions the same way as in Symfony. However, you would usually need to manually perform import for your routing configuration in the main routing.yml file in your config directory like this:

config/routing.yml 
 default_controller:
     resource: "@AcmeDemoBundle/Controller/DefaultController.php"
     type:     annotation

 acme_demo:
     resource: "@AcmeDemoBundle/Resources/config/routing.yml"
     prefix: /demo

With OroPlatform, you can still configure your routes the way you like. As long as you create the main routing.yml file in the bundle’s Resources/config/oro directory, you do not have to register your routing config in the application config; it will be discovered automatically.

Access Control Lists 

Access Control Lists (ACLs) usually involve working with the ACL provider, object identities, ACEs, the mask builder, etc. OroPlatform makes things more accessible by providing the @Acl annotation that you can use to define an ACL and protect a controller in a single step:

src/Acme/Bundle/DemoBundle/Controller/BlogController.php 
 namespace Acme\Bundle\DemoBundle\Controller;

 use Oro\Bundle\SecurityBundle\Annotation\Acl;

 // ...

 /**
  * @Acl(
  *     id="acme_demo.blog_post_view",
  *     type="entity",
  *     class="AcmeDemoBundle:BlogPost",
  *     permission="VIEW"
  * )
  */
 public function indexAction()
 {
     // ...
 }

Furthermore, once an ACL has been defined, you can reuse it using the @AclAncestor annotation:

src/Acme/Bundle/DemoBundle/Controller/BlogController.php 
namespace Acme\Bundle\DemoBundle\Controller;

use Oro\Bundle\SecurityBundle\Annotation\AclAncestor;

// ...

/**
 * @AclAncestor("acme_demo.blog_post_view")
 */
public function postAction()
{
    // ...
}

See also

For more information, see Security documentation.

Extension Management 

With the Composer, you can easily pull in third-party libraries and bundles for the application. Aside from using Composer to manage dependency management, OroPlatform supports Oro extensions. An extension is a package that adds new features to the Platform. To achieve this, the OroDistributionBundle leverages Composer and Packagist. All extensions feature on the Oro Extensions Store. You do not have to use the command line to install extensions unless you want to, and a user with admin permissions can install them on their own in the UI.

See also

You can also add your own extension to the Oro Extensions Store.