PHPackages                             aimeos/aimeos-symfony2 - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. aimeos/aimeos-symfony2

Abandoned → [aimeos/aimeos-symfony](/?search=aimeos%2Faimeos-symfony)Symfony-bundle[Framework](/categories/framework)

aimeos/aimeos-symfony2
======================

Professional, full-featured and high performance Symfony e-commerce bundle for online shops and complex B2B projects

2026.04.1(1w ago)1.5k71852MITCSSPHP ^8.2CI failing

Since Mar 11Pushed 5mo ago14 watchersCompare

[ Source](https://github.com/aimeos/aimeos-symfony)[ Packagist](https://packagist.org/packages/aimeos/aimeos-symfony2)[ Docs](https://aimeos.org/Symfony)[ RSS](/packages/aimeos-aimeos-symfony2/feed)WikiDiscussions master Synced yesterday

READMEChangelogDependencies (62)Versions (110)Used By (0)

[ ![Aimeos logo](https://camo.githubusercontent.com/e55b7a8426f14ba6040d604746b03b7e096af41ede8fead0ea817cbb8d60f998/68747470733a2f2f61696d656f732e6f72672f66696c6561646d696e2f74656d706c6174652f69636f6e732f6c6f676f2e706e67 "Aimeos")](https://aimeos.org/)Aimeos Symfony bundle
=====================

[](#aimeos-symfony-bundle)

[![Total Downloads](https://camo.githubusercontent.com/8f9334cfca6d7209fdcbfaada858f23f15959c59e29a54ff89995f81a4d6d68d/68747470733a2f2f706f7365722e707567782e6f72672f61696d656f732f61696d656f732d73796d666f6e792f642f746f74616c2e737667)](https://packagist.org/packages/aimeos/aimeos-symfony)[![Build Status](https://camo.githubusercontent.com/c94952b7a060940e211a217801b6d51c7539a3928d89d69d8fb653a3adb3e3d7/68747470733a2f2f7472617669732d63692e6f72672f61696d656f732f61696d656f732d73796d666f6e792e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/aimeos/aimeos-symfony)[![Coverage Status](https://camo.githubusercontent.com/f709d36cbd983cdc11213a31efa30849f1222a500c95f971596d71e3139a0502/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f61696d656f732f61696d656f732d73796d666f6e792f62616467652e7376673f6272616e63683d6d6173746572)](https://coveralls.io/r/aimeos/aimeos-symfony?branch=master)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/b715bf21264bb35a6ad86e153cd66d3c7645aa4b958a4ddf3e91e13a951d91ee/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f61696d656f732f61696d656f732d73796d666f6e792f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/aimeos/aimeos-symfony/?branch=master)

⭐ Star us on GitHub — it helps!

[Aimeos](https://aimeos.org/Symfony) is THE professional, full-featured and ultra fast e-commerce package for Symfony! You can install it in your existing Symfony application within 5 minutes and can adapt, extend, overwrite and customize anything to your needs.

[![Aimeos Symfony demo](https://camo.githubusercontent.com/4cc4e2e8c8624f003fe7c3791b437a0c4b1b4cb91eef7b17d9e083a369ed0676/68747470733a2f2f61696d656f732e6f72672f66696c6561646d696e2f61696d656f732e6f72672f696d616765732f61696d656f732d6769746875622e706e67)](http://symfony.demo.aimeos.org/)

Table of content
----------------

[](#table-of-content)

- [Installation](#installation)
- [Composer](#composer)
- [Admin](#admin)
- [Hints](#hints)
- [License](#license)
- [Links](#links)

Installation
------------

[](#installation)

This document is for the latest **Aimeos 2023.10** and **Symfony 6.3+**.

If you want to **upgrade between major versions**, please have a look into the [upgrade guide](https://aimeos.org/docs/Symfony/Upgrade)!

The Aimeos Symfony e-commerce bundle is a composer based library that can be installed easiest by using [Composer](https://getcomposer.org). If you don't have an existing Symfony application, you can create a skeleton application using

```
composer create-project symfony/website-skeleton:~4.4 myshop
cd myshop

```

These settings need to be added to the `./config/packages/fos_user.yaml` file:

```
fos_user:
    db_driver: orm
    user_class: Aimeos\ShopBundle\Entity\FosUser
    firewall_name: aimeos_myaccount
    from_email:
        address: "me@example.com"
        sender_name: "Test shop"
    service:
        mailer: 'fos_user.mailer.noop'
```

The Aimeos components have to be configured as well to get authentication working correctly. You need to take care of three things: Using the correct customer manager implementation and password encryption method as well as the right path for the storages. All must be appended at the end of the `./config/packages/aimeos_shop.yaml`:

```
aimeos_shop:
    resource:
        fs:
            baseurl: "https://yourdomain.com/"
            basedir: "%kernel.project_dir%/public"
        fs-admin:
            basedir: "%kernel.project_dir%/public/uploads"
    mshop:
        customer:
            manager:
                name: FosUser
                password:
                    name: Bcrypt
```

To configure the Aimeos routing, create the file `./config/routes/aimeos_shop.yaml` with these lines:

```
aimeos_shop:
    resource: "@AimeosShopBundle/config/routing.yaml"
```

The same applies for the FosUser bundle. Create the file `./config/routes/fos_user.yaml` containing:

```
fos_user:
    resource: "@FOSUserBundle/Resources/config/routing/all.xml"
```

Make sure that the database is set up and it is configured in your `./config/packages/doctrine.yaml`:

```
parameters:
    env(DATABASE_URL): ''
    database_host:
    database_port:
    database_name:
    database_user:
    database_password:
```

Also, you have to configure your database credentials in the `.env` file:

`DATABASE_URL=mysql://db_user:db_password@127.0.0.1:3306/db_name`

If you want to use a database server other than MySQL, please have a look into the article about [supported database servers](https://aimeos.org/docs/latest/infrastructure/databases/)and their specific configuration.

If you don't use Sendmail but SMTP for sending e-mails, you have to adapt the `MAILER_URL`configuration in your `.env` file, e.g.:

`MAILER_URL=smtp://smtp.mailtrap.io:2525?encryption=tls&auth_mode=login&username=...&password=...`

Composer
--------

[](#composer)

Then add these lines to your `composer.json` of your Symfony project:

```
    "prefer-stable": true,
    "minimum-stability": "dev",
    "require": {
        "aimeos/aimeos-symfony": "~2023.10",
        "friendsofsymfony/user-bundle": "^3.2",
        ...
    },
    "scripts": {
        "post-install-cmd": [
            "Aimeos\\ShopBundle\\Composer\\ScriptHandler::installBundle",
            "Aimeos\\ShopBundle\\Composer\\ScriptHandler::setupDatabase",
            ...
        ],
        "post-update-cmd": [
            "Aimeos\\ShopBundle\\Composer\\ScriptHandler::installBundle",
            "Aimeos\\ShopBundle\\Composer\\ScriptHandler::setupDatabase",
            ...
        ]
    }
```

Afterwards, install the Aimeos shop bundle using

`composer update`

In a production environment or if you don't want that the demo data gets installed, use the --no-dev option:

`SYMFONY_ENV=prod composer update --no-dev`

If you get an exception that the `SensioGeneratorBundle` isn't found, follow the steps described in the [Aimeos Symfony forum post](https://aimeos.org/help/symfony-bundle-f17/symfony-env-prod-composer-update-no-dev-t1488.html#p6384)

Start the PHP web server in the base directory of your application to do some quick tests:

`php -S 127.0.0.1:8000 -t public`

Then, you should be able to call the catalog list page in your browser using

`http://127.0.0.1:8000/shop`

Login and Admin
---------------

[](#login-and-admin)

Setting up the administration interface is a matter of configuring the Symfony firewall to restrict access to the admin URLs.

Setting up the security configuration is the most complex part. The firewall setup in `./config/packages/security.yaml` should look like this one:

```
security:
    providers:
        aimeos:
            entity: { class: Aimeos\ShopBundle\Entity\FosUser, property: username }

    password_hashers:
        Aimeos\ShopBundle\Entity\FosUser: bcrypt

    firewalls:
        aimeos_admin:
            pattern: ^/admin
            provider: aimeos
            form_login:
                login_path: /admin
                check_path: /admin_check
        aimeos_myaccount:
            pattern: ^/
            form_login:
                provider: aimeos
                csrf_token_generator: security.csrf.token_manager
            logout: true

    access_control:
        - { path: ^/login$, role: IS_AUTHENTICATED_ANONYMOUSLY }
        - { path: ^/register, role: IS_AUTHENTICATED_ANONYMOUSLY }
        - { path: ^/resetting, role: IS_AUTHENTICATED_ANONYMOUSLY }
        - { path: ^/profile, roles: ROLE_USER }
        - { path: ^/admin/.+, roles: [ROLE_ADMIN, ROLE_SUPER_ADMIN] }
```

**Caution:** The order of the configuration settings in this file is important!

These settings will protect the `/admin/*` URLs from unauthorized access from someone without admin privileges.

The `/profile` URL is protected by the FOS user bundle as well, which also offers user registration.

As last step, you have to create an admin account using the Symfony command line:

```
./bin/console aimeos:account --admin me@mydomain.com
```

The e-mail address is the user name for login and the account will work for the frontend too. To protect the new account, the command will ask you for a password. The same command can create limited accounts by using "--editor" instead of "--admin". If you use "--super" the account will have access to all sites.

If the PHP web server is still running (`php -S 127.0.0.1:8000 -t public`), you should be able to call the admin login page in your browser using

`http://127.0.0.1:8000/admin`

and authenticating with your e-mail and the password which has been asked for by the `aimeos:account` command.

Hints
-----

[](#hints)

To simplify development, you should configure to use no content cache. You can do this by adding these lines to `./config/packages/aimeos_shop.yaml`:

```
aimeos_shop:
    madmin:
        cache:
            manager:
                name: None
```

License
-------

[](#license)

The Aimeos Symfony bundle is licensed under the terms of the MIT license and is available for free.

Links
-----

[](#links)

- [Web site](https://aimeos.org/Symfony)
- [Documentation](https://aimeos.org/docs/latest/symfony/)
- [Forum](https://aimeos.org/help/symfony-bundle-f17/)
- [Issue tracker](https://github.com/aimeos/aimeos-symfony/issues)
- [Composer packages](https://packagist.org/packages/aimeos/aimeos-symfony)
- [Source code](https://github.com/aimeos/aimeos-symfony)

###  Health Score

64

—

FairBetter than 99% of packages

Maintenance83

Actively maintained with recent releases

Popularity39

Limited adoption so far

Community24

Small or concentrated contributor base

Maturity92

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 96.3% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~37 days

Recently: every ~415 days

Total

109

Last Release

12d ago

Major Versions

2020.10.3 → 2021.01.x-dev2021-01-13

2020.10.4 → 2021.04.32021-06-11

2020.10.x-dev → 2021.04.x-dev2021-06-24

2021.10.x-dev → 2023.10.x-dev2023-11-14

2023.10.x-dev → 2026.04.12026-04-29

PHP version history (6 changes)1.0.0PHP &gt;=5.3.3

2019.01.1PHP &gt;=5.5.0

2019.04.1PHP &gt;=7.1.0

2020.01.1PHP ~7.1

2023.10.x-devPHP ^8.0.11

2026.04.1PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/ccdc84033584516c77fb6aa7f85dc7048f2fbcd08867fc6abf115d094bab5eef?d=identicon)[aimeos](/maintainers/aimeos)

---

Top Contributors

[![aimeos](https://avatars.githubusercontent.com/u/8647429?v=4)](https://github.com/aimeos "aimeos (1050 commits)")[![garwat82](https://avatars.githubusercontent.com/u/9195993?v=4)](https://github.com/garwat82 "garwat82 (14 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (14 commits)")[![scrutinizer-auto-fixer](https://avatars.githubusercontent.com/u/6253494?v=4)](https://github.com/scrutinizer-auto-fixer "scrutinizer-auto-fixer (8 commits)")[![zanbaldwin](https://avatars.githubusercontent.com/u/123245?v=4)](https://github.com/zanbaldwin "zanbaldwin (1 commits)")[![LaKrue](https://avatars.githubusercontent.com/u/744620?v=4)](https://github.com/LaKrue "LaKrue (1 commits)")[![lgeorget](https://avatars.githubusercontent.com/u/4492093?v=4)](https://github.com/lgeorget "lgeorget (1 commits)")[![xabbuh](https://avatars.githubusercontent.com/u/1957048?v=4)](https://github.com/xabbuh "xabbuh (1 commits)")

---

Tags

aimeosb2be-commerceecommercejson-apimarketplaceperformancephpshopsymfonysymfony-ecommerce-bundlesymfonyshopecommercee-commerceb2baimeosportalmarket place

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/aimeos-aimeos-symfony2/health.svg)

```
[![Health](https://phpackages.com/badges/aimeos-aimeos-symfony2/health.svg)](https://phpackages.com/packages/aimeos-aimeos-symfony2)
```

###  Alternatives

[aimeos/aimeos-symfony

Professional, full-featured and high performance Symfony e-commerce bundle for online shops and complex B2B projects

1.4k4.3k](/packages/aimeos-aimeos-symfony)[aimeos/aimeos-typo3

Professional, full-featured and high performance TYPO3 e-commerce extension for online shops and complex B2B projects

1.5k91.2k4](/packages/aimeos-aimeos-typo3)[aimeos/aimeos-laravel

Cloud native, API first Laravel eCommerce package with integrated AI for ultra-fast online shops, marketplaces and complex B2B projects

8.6k214.7k3](/packages/aimeos-aimeos-laravel)[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.0k15.4k](/packages/prestashop-prestashop)[ec-cube/ec-cube

EC-CUBE EC open platform.

78527.0k1](/packages/ec-cube-ec-cube)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
