PHPackages                             aimeos/aimeos-symfony - 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-symfony

ActiveSymfony-bundle[Framework](/categories/framework)

aimeos/aimeos-symfony
=====================

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

2021.10.1(4y ago)1.4k4.3k↓66.7%52MITCSSPHP ~7.1CI failing

Since Mar 11Pushed 5mo ago14 watchersCompare

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

READMEChangelogDependencies (32)Versions (108)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

52

—

FairBetter than 96% of packages

Maintenance49

Moderate activity, may be stable

Popularity45

Moderate usage in the ecosystem

Community24

Small or concentrated contributor base

Maturity75

Established project with proven stability

 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 ~30 days

Recently: every ~213 days

Total

107

Last Release

909d ago

Major Versions

2019.10.x-dev → 2020.10.22020-10-28

2020.10.3 → 2021.01.x-dev2021-01-13

2020.10.4 → 2021.04.32021-06-11

2020.10.5 → 2021.04.x-dev2021-06-24

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

PHP version history (5 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

### 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-symfony/health.svg)

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

###  Alternatives

[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)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.3M152](/packages/sulu-sulu)

PHPackages © 2026

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