norvutec/multi-tenancy

Allows multiple tenants inside a single application

1.0.9 2025-04-08 13:54 UTC

Requires

• php: >=8.2
• ext-ctype: *
• ext-iconv: *
• doctrine/dbal: ^3
• doctrine/doctrine-bundle: ^2.12
• doctrine/doctrine-migrations-bundle: ^3.3
• doctrine/orm: ^3.2
• symfony/console: 7.2.*
• symfony/dotenv: 7.2.*
• symfony/flex: ^2
• symfony/framework-bundle: 7.2.*
• symfony/runtime: 7.2.*
• symfony/serializer: 7.2.*
• symfony/validator: 7.2.*
• symfony/yaml: 7.2.*

Conflicts

• symfony/symfony: *

proprietary

• NorvuTec UG (haftungsbeschränkt)

README

The Multi-Tenancy Bundle will manage the multi-tenancy for your Symfony application.
It will allow you to have multiple tenants in your application and manage them easily.

The tenancy currently supports the following features:

• Database Configuration per Tenant

Installation

composer require norvutec/multi-tenancy

Doctrine Configuration

doctrine:
    dbal:
        default_connection: default
        connections:
          default:
              url: '%env(resolve:DATABASE_URL)%'
              driver: 'pdo_mysql'
              charset: utf8mb4
              server_version: '10.6.16-MariaDB'
              profiling_collect_backtrace: '%kernel.debug%'
              use_savepoints: true
          tenant:
            url: '%env(resolve:DATABASE_URL)%'
            driver: 'pdo_mysql'
            charset: utf8mb4
            server_version: '10.6.16-MariaDB'
            profiling_collect_backtrace: '%kernel.debug%'
            use_savepoints: true
            wrapper_class: Norvutec\MultiTenancyBundle\Doctrine\DBAL\TenantConnection

    orm:
        default_entity_manager: default
        entity_managers:
            default:
                connection: default
                mappings:
                  System:
                      is_bundle: false
                      type: attribute
                      dir: '%kernel.project_dir%/src/Entity/System'
                      prefix: 'App\Entity\System'
                      alias: System
            tenant:
                connection: tenant
                mappings:
                  Tenant:
                    is_bundle: false
                    type: attribute
                    dir: '%kernel.project_dir%/src/Entity/Tenant'
                    prefix: 'App\Entity\Tenant'
                    alias: Tenant

Multi-Tenancy Configuration

Create File config/packages/multi_tenancy.yaml

multi_tenancy:
  tenant_class: App\Entity\System\Tenant ## Class Implementing Tenant Interface
  tenant_select_route: app_test2 ## Route for Tenant Selection redirection
  tenant_migration_config: 'config/migrations/tenant.yaml' ## Migration Configuration for Tenant