README

🧩 Overview

The Symfony Multi-Tenancy Bundle enables scalable, production-ready multi-tenancy for Symfony applications.

Ideal for SaaS platforms, region-based services, and multi-vendor e-commerce systems.

This bundle is designed around a database-per-tenant architecture, where each tenant (e.g., company, region, or seller) has its own isolated database.

It provides a flexible foundation for building multi-tenant SaaS platforms where each tenant has:

A fully isolated database
Independent schema migration lifecycle
Dedicated entity structure

This model supports both:

Customer-based tenancy (each company/user gets their own DB)
Region-based tenancy (databases split per country, region, or legal boundary)

The bundle integrates seamlessly with Doctrine and Symfony’s service container, offering:

Automatic tenant database switching at runtime
Configurable DB hosts, drivers, and credentials per tenant
Separate migration/fixture directories for main and tenant databases
Runtime isolation without needing multiple Symfony instances

Ideal for developers building:

B2B SaaS platforms
Regional/multi-country deployments
Multi-vendor marketplaces
White-label or agency platforms requiring isolated data per client where each tenant has a fully isolated database, such as B2B SaaS, white-label apps, or geo-distributed services.

✨ Feature Overview

Feature	Description
🧠 Runtime DB Switching	Switch between tenant databases dynamically using `SwitchDbEvent`
🗂️ Separate Entity Mapping	Support for separate entity directories for Main and Tenant
🧠 Dedicated `TenantEntityManager` Service	Injected once and automatically connects to the target tenant DB after `SwitchDbEvent` is dispatched.
🧰 Custom Doctrine Commands	Extended commands like `tenant:database:create`, `tenant:migration:migrate`, etc. for managing tenant DBs
📦 Tenant Migrations Tracked Independently from Main DB	All tenant databases share a dedicated migration path and history, completely separate from the main database migrations
🆕 🔁 Bulk Tenant Migration Execution	Migrate all tenant DBs to latest schema using one command
🆕🏗️ On-the-Fly Tenant DB Creation	Create tenant DBs automatically if they don’t exist
🆕 ✅ Tenant Fixtures with `tenant:fixtures:load`	Load fixtures per tenant DB using `#[TenantFixture]` attribute — works like default Doctrine with full option support
🆕 🔄 Tenant Fixture Ordering / Dependencies	Fully supports `getDependencies()` and `getOrder()` just like native fixtures
🆕 🌍 Per-Tenant DB Host Configuration	Tenants can point to different DB hosts based on configuration in the entity
🆕 🔐 Per-Tenant DB Credentials	Shared credentials per host; each host can have its own user/pass used for all associated tenants
🆕 🔧 Per-Tenant DB Driver Support	Main and Tenant DBs can use different drivers (e.g. PostgreSQL main, MySQL tenant)

These features empower Symfony apps to operate with multiple isolated databases efficiently — great for SaaS and region-based tenancy.

📦 Using the Bundle

The idea behind this bundle is simple: you have a main database and multiple tenant databases. Here's how to use it:

Create a configuration entity in your main database that implements TenantDbConfigurationInterface.
- Use TenantDbConfigTrait to include all required fields.
- Use TimestampableTrait for createdAt and updatedAt fields, and add the #[ORM\HasLifecycleCallbacks] attribute.
Split your entities into two directories:
- src/Entity/Main/ for main DB entities
- src/Entity/Tenant/ for tenant DB entities
Split migrations into two directories:
- src/Migrations/Main/
- src/Migrations/Tenant/
Inject TenantEntityManager in your services or controllers.
Switch to a tenant DB by dispatching:

$dispatcher->dispatch(new SwitchDbEvent($tenantId));

This will connect the TenantEntityManager to the database of the given tenant ID.

Recommended: Keep tenant entities in a different directory from main entities for clean structure and separation.

✅ New: Load Tenant Fixtures with `tenant:fixtures:load`

You can now load tenant-specific fixtures just like regular Doctrine fixtures by simply using the #[TenantFixture] attribute.

🔧 How to use:

Annotate your fixture class with the attribute:

use Hakam\MultiTenancyBundle\Attribute\TenantFixture;

#[TenantFixture]
class ProductFixtures extends Fixture
{
    public function load(ObjectManager $manager): void
    {
        // your fixture logic
    }
}

Run the command:
```
php bin/console tenant:fixtures:load
```

Supports --append, --group=, --purge-with-truncate, --dbid=, and fixture dependencies like native Doctrine fixtures.

🛠 Supported Databases

MySQL / MariaDB
PostgreSQL
SQLite

⚙️ Installation

You can install the Multi-Tenancy Bundle using Symfony Flex (recommended) or set it up manually.

✅ Option 1: Install via Symfony Flex (Recommended)

📦 Step 1: Install the bundle

composer require hakam/multi-tenancy-bundle

⚙️ Symfony Flex will automatically:

Register the bundle in config/bundles.php
Copy default config to config/packages/hakam_multi_tenancy.yaml
Create the following directory structure:

src/Entity/Main/
src/Entity/Tenant/
migrations/Main/
migrations/Tenant/

🛠 Step 2: Update Doctrine Configuration

In config/packages/doctrine.yaml:

doctrine:
  dbal:
    default_connection: default
    url: '%env(resolve:DATABASE_URL)%'

  orm:
    default_entity_manager: default
    entity_managers:
      default:
        connection: default
        auto_mapping: false
        mappings:
          Main:
            is_bundle: false
            dir: '%kernel.project_dir%/src/Entity/Main'
            prefix: 'App\\Entity\\Main'
            alias: App

In config/packages/doctrine_migrations.yaml:

doctrine_migrations:
  migrations_paths:
    'DoctrineMigrations\\Main': '%kernel.project_dir%/src/Migrations/Main'

🧱 Option 2: Manual Installation (Without Symfony Flex)

📦 Step 1: Install the bundle

composer require hakam/multi-tenancy-bundle

🧩 Step 2: Register the bundle manually

In config/bundles.php:

return [
    // ...
    Hakam\MultiTenancyBundle\HakamMultiTenancyBundle::class => ['all' => true],
];

⚙️ Step 3: Create the default configuration

Create the file config/packages/hakam_multi_tenancy.yaml:

hakam_multi_tenancy:
  tenant_database_className:  App\Entity\Main\TenantDbConfig
  tenant_database_identifier: id

  tenant_connection:
    host: 127.0.0.1
    port: 3306
    driver: pdo_mysql
    charset: utf8
    server_version: 5.7

  tenant_migration:
    tenant_migration_namespace: DoctrineMigrations\Tenant
    tenant_migration_path: migrations/Tenant

  tenant_entity_manager:
    tenant_naming_strategy: doctrine.orm.naming_strategy.underscore_number_aware
    mapping:
      type: attribute
      dir: '%kernel.project_dir%/src/Entity/Tenant'
      prefix: App\Entity\Tenant
      alias: Tenant

📁 Step 4: Manually create the following folders

src/Entity/Main/
src/Entity/Tenant/
migrations/Main/
migrations/Tenant/

🗂️ Step 5: Update Doctrine Configuration

In config/packages/doctrine.yaml:

doctrine:
  dbal:
    default_connection: default
    url: '%env(resolve:DATABASE_URL)%'

  orm:
    default_entity_manager: default
    entity_managers:
      default:
        connection: default
        auto_mapping: false
        mappings:
          Main:
            is_bundle: false
            dir: '%kernel.project_dir%/src/Entity/Main'
            prefix: 'App\\Entity\\Main'
            alias: App

In config/packages/doctrine_migrations.yaml:

doctrine_migrations:
  migrations_paths:
    'DoctrineMigrations\\Main': '%kernel.project_dir%/src/Migrations/Main'

🎉 You’re now ready to define your tenant configuration entity and start using the bundle's powerful multi-tenancy features.

🧠 Get Started Example

Generate & run the main migration:

php bin/console doctrine:migrations:diff
php bin/console doctrine:migrations:migrate

Create a TenantDbConfig record in the main database.
Create a tenant database:
```
php bin/console tenant:database:create
```

Switch to tenant database in controller:

$dispatcher->dispatch(new SwitchDbEvent($tenant->getId()));
$tenantEntityManager->persist($entity);

Use tenant migration commands:

php bin/console tenant:migration:diff
php bin/console tenant:migration:migrate update

🔄 Doctrine Commands for Tenants

Command	Description
`tenant:database:create`	Create tenant DBs that don’t exist yet
`tenant:migration:diff`	Generate migrations for tenants
`tenant:migration:migrate init`	Migrate newly created tenant DBs
`tenant:migration:migrate update`	Migrate all tenant DBs to the latest version
`tenant:fixtures:load`	Load fixtures for tenant DBs

ℹ️ All commands support the optional --dbid= argument to run the command for a specific tenant database.
If --dbid is not provided, the first available (default) tenant DB will be used.

Example

You can check this project example Multi-Tenant Bundle Example to see how to use the bundle.

Notes:

All the doctrine migration commands and files are generated and executed especially for tenant databases independent of the main db migrations, Thanks for Doctrine migration bundle v3+ .

All the tenant databases migrations will be saved in the same directory you configured for tenant entities.

Get Started Example

After configuring the bundle as we mentioned above , you can use the following steps to get started.
You need to generate the main database migration with the new entity first. example php bin/console doctrine:migrations:diff
Then migrate the main database. example php bin/console doctrine:migrations:migrate
Now you are ready to create new tenant databases and switch between them.
To create a new tenant database and execute the migration for it. Add the TenantDbConfig entity to your main database. then you can use the following command. example php bin/console tenant:database:create this command will create a new tenant database and execute the migration for it.
To switch to a tenant database. example $this->dispatcher->dispatch(new SwitchDbEvent($tenantDb->getId())); then you can use the TenantEntityManager to execute your queries.
You can add a relation between your tenant entity and the TenantDbConfig entity to get the tenant db config easily.

<?php
      public Class AppController extends AbstractController
      {
        public function __construct(
        private EntityManagerInterface $mainEntityManager,
        private TenantEntityManager $tenantEntityManager,
        private EventDispatcherInterface $dispatcher
    ) {
    }
      public function switchToLoggedInUserTenantDb(): void
      {
        $this->dispatcher->dispatch(new SwitchDbEvent($this->getUser()->getTenantDbConfig()->getId()));
        // Now you can use the tenant entity manager to execute your queries.
      }
    }

You can use the custom doctrine commands for tenant databases to perform the same doctrine commands on tenant databases. example php bin/console tenant:migration:diff to generate migration for tenant db. example php bin/console tenant:migration:migrate update to execute migration for all tenant db to the latest version.
Now You can work with the TenantEntityManager as you work with the main entity manager.
You can now add or delete entities from the main or tenant databases and generate migrations for each database separately.

<?php

namespace App\Controller;

use App\Entity\Main\TenantDbConfig;
use Hakam\MultiTenancyBundle\Services\DbService;
use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\EventDispatcher\EventDispatcherInterface;
use Hakam\MultiTenancyBundle\Event\SwitchDbEvent;
use Hakam\MultiTenancyBundle\Doctrine\ORM\TenantEntityManager;
use Doctrine\ORM\EntityManagerInterface;
use App\Entity\Tenant\TestEntity;
use App\Entity\Main\MainEntity;
use Symfony\Component\HttpFoundation\JsonResponse;
use Symfony\Component\Routing\Annotation\Route;

class MultiTenantController extends AbstractController
{
    public function __construct(
        private EntityManagerInterface $mainEntityManager,
        private TenantEntityManager $tenantEntityManager,
        private EventDispatcherInterface $dispatcher,
        private DbService $dbService,
    ) {
    }
    /**
     * An example of how to switch and update tenant databases
     */
    #[Route('/test_db', name: 'app_test_db')]
    public function testDb(EntityManagerInterface $entityManager)
    {

        $tenantDbConfigs = $this->mainEntityManager->getRepository(TenantDbConfig::class)->findAll();

        foreach ($tenantDbConfigs as $tenantDbConfig) {
            // Dispatch an event with the index ID for the entity that contains the tenant database connection details.
            $switchEvent = new SwitchDbEvent($tenantDbConfig->getId());
            $this->dispatcher->dispatch($switchEvent);

            $tenantEntity1 = new TestEntity();
            $tenantEntity1->setName($tenantDbConfig->getDbName());

            $this->tenantEntityManager->persist($tenantEntity1);
            $this->tenantEntityManager->flush();
        }

        // Add a new entity to the main database.
        $mainLog = new MainEntity();
        $mainLog->setName('mainTest');
        $this->mainEntityManager->persist($mainLog);
        $this->mainEntityManager->flush();

        return new JsonResponse();
    }
}

Configuration

In this example below you can find the list of all configuration parameters required witch you should create in config/packages/hakam_multi_tenancy.yaml with this configuration:

hakam_multi_tenancy:
 tenant_database_className:  App\Entity\Main\TenantDbConfig    # tenant dbs configuration Class Name
 tenant_database_identifier: id                                # tenant db column name to get db configuration
 tenant_connection:                                            # tenant entity manager connection configuration
   host:     127.0.0.1
   port:     3306                                              # default is 3306
   driver:   pdo_mysql 
   charset:  utf8 
   server_version: 5.7                                         # mysql server version

 tenant_migration:                                             # tenant db migration configurations, Its recommended to have a different migration for tenants dbs than you main migration config
   tenant_migration_namespace: Application\Migrations\Tenant
   tenant_migration_path: migrations/Tenant
 tenant_entity_manager:                                        # tenant entity manger configuration , which is used to manage tenant entities
   tenant_naming_strategy: doctrine.orm.naming_strategy.underscore_number_aware # tenant entity manager naming strategy - usually the same as in doctrine.yaml
   dql:                                                        # tenant entity manager dql configuration
     string_functions:
       test_string: App\DQL\StringFunction
       second_string: App\DQL\SecondStringFunction
     numeric_functions:
       test_numeric: App\DQL\NumericFunction
     datetime_functions:
       test_datetime: App\DQL\DatetimeFunction
   mapping:                                                  
     type:   attribute                                          # mapping type default annotation                                                       
     dir:   '%kernel.project_dir%/src/Entity/Tenant'           # directory of tenant entities, it could be different from main directory                                           
     prefix: App\Entity\Tenant                                 # tenant entities prefix  ex "App\Entity\Tenant"
     alias:   Tenant                                           # tenant entities alias  ex "Tenant"

Suggested Patterns For Use

User

Store the users current tenant ID in the session or the User entity. This allows you to get the current tenant at any time.

Tenant Interface

Implement an interface on all your tenant entities. This allows you to identify if an entity is associated with a tenant object. Then you can get the current tenant ID from the current user, and switch the entity manager to the tenant DB.

namespace App\Entity\Tenant;

use App\Model\OrgActivitySuperclass;
use App\Repository\Tenant\OrgActivityRepository;
use Doctrine\ORM\Mapping as ORM;
use Hakam\MultiTenancyBundle\Model\TenantEntityInterface;

#[ORM\Entity(repositoryClass: OrgActivityRepository::class)]
class OrgActivity extends OrgActivitySuperclass implements TenantEntityInterface
{
    #[ORM\Id]
    #[ORM\GeneratedValue]
    #[ORM\Column]
    private ?int $id = null;
           
}

Custom Controller

Extend your base controller class to overwrite some of the normal controller functions for persistence.

<?php

namespace App\Controller;

use App\Entity\Main\Tenant;
use App\Entity\Tenant\Organisation;
use Hakam\MultiTenancyBundle\Doctrine\ORM\TenantEntityManager;
use Hakam\MultiTenancyBundle\Event\SwitchDbEvent;
use Hakam\MultiTenancyBundle\Model\TenantEntityInterface;
use Psr\EventDispatcher\EventDispatcherInterface;
use Symfony\Bundle\SecurityBundle\Security;
use Umbrella\CoreBundle\Controller\BaseController;

abstract class DbSwitcherController extends BaseController
{
    public function __construct(private EventDispatcherInterface $eventDispatcher, private TenantEntityManager $tenantEntityManager)
    {
    }
    
    protected function switchDb(Tenant $tenant): Organisation
    {

        // Switch the TenantEntityManager to the current tenant.
        $event = new SwitchDbEvent($tenant->getId());
        $this->eventDispatcher->dispatch($event);

        // Optional depending on your usage, here we return the top entity whenever we switch to a new Tenant DB.
        $organisation = $this->tenantEntityManager->getRepository(Organisation::class)
            ->findOneIdByXeroOrganisationId($tenant->getXeroOrganisationId());

        return $organisation;
    }

    /**
     * Override parent method to check if the entity is a Tenant entity or main entity. Return which ever is appropriate.
     */  
    protected function findOrNotFound(string $className, $id)
    {

        $em = $this->em();

        $reflection = new \ReflectionClass($className);

        if ($reflection instanceof TenantEntityInterface) {
            $em = $this->tenantEntityManager;
        }

        $e = $em->find($className, $id);
        $this->throwNotFoundExceptionIfNull($e);

        return $e;
    }

    /**
     * Override parent method to check if the entity is a Tenant entity or main entity. Return which ever is appropriate.
     */  
    protected function persistAndFlush($entity): void
    {
        if ($entity instanceof TenantEntityInterface) {
            $this->tenantEntityManager->persist($entity);
            $this->tenantEntityManager->flush();
            return;
        }
        $this->em()->persist($entity);
        $this->em()->flush();
    }

    /**
     * Override parent method to check if the entity is a Tenant entity or main entity. Return which ever is appropriate.
     */  
    protected function removeAndFlush($entity): void
    {
        if ($entity instanceof TenantEntityInterface) {
            $this->tenantEntityManager->remove($entity);
            $this->tenantEntityManager->flush();
            return;
        }
        $this->em()->remove($entity);
        $this->em()->flush();
    }
}

Custom Value Resolver

Symfony uses an Entity Value Resolver to load entities associated with parameters passed to controller actions. https://symfony.com/doc/current/controller/value_resolver.html

This resolver is essential to making sure your IsGranted and other Security actions work in the controllers.

Create a custom entity value resolver to switch based on a ReflectionClass of the entity (based on the TenantEntityInterface).

You can copy the value resolver here: https://github.com/symfony/symfony/blob/6.2/src/Symfony/Bridge/Doctrine/ArgumentResolver/EntityValueResolver.php

And modify it to exclude non TenantEntityInterface objects. Then switch DB based on the current user tenant.

<?php

namespace App\ValueResolver;

namespace App\ValueResolver;

use Doctrine\DBAL\Types\ConversionException;
use Doctrine\ORM\EntityManagerInterface;
use Doctrine\ORM\NoResultException;
use Doctrine\Persistence\ManagerRegistry;
use Doctrine\Persistence\ObjectManager;
use Hakam\MultiTenancyBundle\Doctrine\ORM\TenantEntityManager;
use Hakam\MultiTenancyBundle\Event\SwitchDbEvent;
use Hakam\MultiTenancyBundle\Model\TenantEntityInterface;
use Psr\EventDispatcher\EventDispatcherInterface;
use Symfony\Bridge\Doctrine\Attribute\MapEntity;
use Symfony\Bundle\SecurityBundle\Security;
use Symfony\Component\ExpressionLanguage\ExpressionLanguage;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpKernel\Controller\ValueResolverInterface;
use Symfony\Component\HttpKernel\ControllerMetadata\ArgumentMetadata;
use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;

class TenantEntityValueResolver implements ValueResolverInterface
{
    public function __construct(
        private ManagerRegistry $registry,
        private Security $security,
        private EventDispatcherInterface $eventDispatcher,
        private TenantEntityManager $tenantEntityManager,
        private MapEntity $defaults = new MapEntity(),
        private ?ExpressionLanguage $expressionLanguage = null,
    ) {
    }

    public function resolve(Request $request, ArgumentMetadata $argument): array
    {
        if (\is_object($request->attributes->get($argument->getName()))) {
            return [];
        }

        $options = $argument->getAttributes(MapEntity::class, ArgumentMetadata::IS_INSTANCEOF);
        $options = ($options[0] ?? $this->defaults)->withDefaults($this->defaults, $argument->getType());

        if (!$options->class || $options->disabled) {
            return [];
        }

        $reflectionClass = new \ReflectionClass($options->class);

        if(!$reflectionClass instanceof TenantEntityInterface){
            return [];
        }

        $currentTenant = $this->security->getUser()->getCurrentTenant();

        $switchEvent = new SwitchDbEvent($currentTenant->getId());
        $this->eventDispatcher->dispatch($switchEvent);

        $manager = $this->tenantEntityManager;

        if (!$manager instanceof TenantEntityManager) {
            return [];
        }

        $message = '';
        if (null !== $options->expr) {
            if (null === $object = $this->findViaExpression($manager, $request, $options)) {
                $message = sprintf(' The expression "%s" returned null.', $options->expr);
            }
            // find by identifier?
        } elseif (false === $object = $this->find($manager, $request, $options, $argument->getName())) {
            // find by criteria
            if (!$criteria = $this->getCriteria($request, $options, $manager)) {
                return [];
            }
            try {
                $object = $manager->getRepository($options->class)->findOneBy($criteria);
            } catch (NoResultException|ConversionException) {
                $object = null;
            }
        }

        if (null === $object && !$argument->isNullable()) {
            throw new NotFoundHttpException(sprintf('"%s" object not found by "%s".', $options->class, self::class).$message);
        }

        return [$object];
    }

    private function getManager(?string $name, string $class): ?ObjectManager
    {
        if (null === $name) {
            return $this->registry->getManagerForClass($class);
        }

        try {
            $manager = $this->registry->getManager($name);
        } catch (\InvalidArgumentException) {
            return null;
        }

        return $manager->getMetadataFactory()->isTransient($class) ? null : $manager;
    }

    private function find(ObjectManager $manager, Request $request, MapEntity $options, string $name): false|object|null
    {
        if ($options->mapping || $options->exclude) {
            return false;
        }

        $id = $this->getIdentifier($request, $options, $name);
        if (false === $id || null === $id) {
            return $id;
        }

        if ($options->evictCache && $manager instanceof EntityManagerInterface) {
            $cacheProvider = $manager->getCache();
            if ($cacheProvider && $cacheProvider->containsEntity($options->class, $id)) {
                $cacheProvider->evictEntity($options->class, $id);
            }
        }

        try {
            return $manager->getRepository($options->class)->find($id);
        } catch (NoResultException|ConversionException) {
            return null;
        }
    }

    private function getIdentifier(Request $request, MapEntity $options, string $name): mixed
    {
        if (\is_array($options->id)) {
            $id = [];
            foreach ($options->id as $field) {
                // Convert "%s_uuid" to "foobar_uuid"
                if (str_contains($field, '%s')) {
                    $field = sprintf($field, $name);
                }

                $id[$field] = $request->attributes->get($field);
            }

            return $id;
        }

        if (null !== $options->id) {
            $name = $options->id;
        }

        if ($request->attributes->has($name)) {
            return $request->attributes->get($name) ?? ($options->stripNull ? false : null);
        }

        if (!$options->id && $request->attributes->has('id')) {
            return $request->attributes->get('id') ?? ($options->stripNull ? false : null);
        }

        return false;
    }

    private function getCriteria(Request $request, MapEntity $options, ObjectManager $manager): array
    {
        if (null === $mapping = $options->mapping) {
            $mapping = $request->attributes->keys();
        }

        if ($mapping && \is_array($mapping) && array_is_list($mapping)) {
            $mapping = array_combine($mapping, $mapping);
        }

        foreach ($options->exclude as $exclude) {
            unset($mapping[$exclude]);
        }

        if (!$mapping) {
            return [];
        }

        // if a specific id has been defined in the options and there is no corresponding attribute
        // return false in order to avoid a fallback to the id which might be of another object
        if (\is_string($options->id) && null === $request->attributes->get($options->id)) {
            return [];
        }

        $criteria = [];
        $metadata = $manager->getClassMetadata($options->class);

        foreach ($mapping as $attribute => $field) {
            if (!$metadata->hasField($field) && (!$metadata->hasAssociation($field) || !$metadata->isSingleValuedAssociation($field))) {
                continue;
            }

            $criteria[$field] = $request->attributes->get($attribute);
        }

        if ($options->stripNull) {
            $criteria = array_filter($criteria, static fn ($value) => null !== $value);
        }

        return $criteria;
    }

    private function findViaExpression(ObjectManager $manager, Request $request, MapEntity $options): ?object
    {
        if (!$this->expressionLanguage) {
            throw new \LogicException(sprintf('You cannot use the "%s" if the ExpressionLanguage component is not available. Try running "composer require symfony/expression-language".', __CLASS__));
        }

        $repository = $manager->getRepository($options->class);
        $variables = array_merge($request->attributes->all(), ['repository' => $repository]);

        try {
            return $this->expressionLanguage->evaluate($options->expr, $variables);
        } catch (NoResultException|ConversionException) {
            return null;
        }
    }
}

Add the value resolver as a service.

services:
    # Priority should fire before the default EntityValueResolver
    App\ValueResolver\TenantEntityValueResolver:
        tags:
            - { name: controller.argument_value_resolver, priority: 150 }

Contribution

Want to contribute? Great!

Fork your copy from the repository
Add your new Awesome features
Write MORE Tests
Create a new Pull request

License

MIT

Free Software, Hell Yeah!

hakam / multi-tenancy-bundle

Maintainers

Details

README

🧩 Overview

✨ Feature Overview

📦 Using the Bundle

✅ New: Load Tenant Fixtures with `tenant:fixtures:load`

🔧 How to use:

🛠 Supported Databases

⚙️ Installation

✅ Option 1: Install via Symfony Flex (Recommended)

📦 Step 1: Install the bundle

⚙️ Symfony Flex will automatically:

🛠 Step 2: Update Doctrine Configuration

🧱 Option 2: Manual Installation (Without Symfony Flex)

📦 Step 1: Install the bundle

🧩 Step 2: Register the bundle manually

⚙️ Step 3: Create the default configuration

📁 Step 4: Manually create the following folders

🗂️ Step 5: Update Doctrine Configuration

🧠 Get Started Example

🔄 Doctrine Commands for Tenants

Example

Notes:

Get Started Example

Configuration

Suggested Patterns For Use

User

Tenant Interface

Custom Controller

Custom Value Resolver

Contribution

License

MIT

hakam / multi-tenancy-bundle

Maintainers

Details

README

🧩 Overview

✨ Feature Overview

📦 Using the Bundle

✅ New: Load Tenant Fixtures with tenant:fixtures:load

🔧 How to use:

🛠 Supported Databases

⚙️ Installation

✅ Option 1: Install via Symfony Flex (Recommended)

📦 Step 1: Install the bundle

⚙️ Symfony Flex will automatically:

🛠 Step 2: Update Doctrine Configuration

🧱 Option 2: Manual Installation (Without Symfony Flex)

📦 Step 1: Install the bundle

🧩 Step 2: Register the bundle manually

⚙️ Step 3: Create the default configuration

📁 Step 4: Manually create the following folders

🗂️ Step 5: Update Doctrine Configuration

🧠 Get Started Example

🔄 Doctrine Commands for Tenants

Example

Notes:

Get Started Example

Configuration

Suggested Patterns For Use

User

Tenant Interface

Custom Controller

Custom Value Resolver

Contribution

License

MIT

✅ New: Load Tenant Fixtures with `tenant:fixtures:load`