hakam/multi-tenancy-bundle

Symfony bundle to extend doctrine to support db switcher and multi tenants

v2.8.3 2025-06-18 18:47 UTC

Requires

• php: ^8.1|^8.2|^8.3
• doctrine/annotations: ^2.0
• doctrine/doctrine-bundle: ^2.7
• doctrine/doctrine-migrations-bundle: ^3.0
• symfony/config: ^5.4.1 | ^v6.4.0|^7.0
• symfony/dependency-injection: ^5.4.1| ^v6.4.0|^7.0
• symfony/filesystem: ^6.4|^7.0
• symfony/http-kernel: ^5.4.1| ^v6.4.0|^7.0
• symfony/orm-pack: ^2.0

Requires (Dev)

• doctrine/doctrine-fixtures-bundle: ^3.6
• phpunit/phpunit: ^9.5
• symfony/phpunit-bridge: ^5.4 | ^v6.4.0|^7.0

Suggests

• doctrine/doctrine-fixtures-bundle: Required to load fixtures for tenants and main database

MIT

• Ramy hakam

README

📚 Full Documentation: https://ramyhakam.github.io/multi_tenancy_bundle/

🧩 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 built around a database-per-tenant architecture, giving each tenant:

• A fully isolated database
• Independent schema and migrations
• Configurable connection parameters (host, driver, credentials)

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

• Automatic tenant database switching at runtime via SwitchDbEvent
• Separate migration and fixture paths for main vs. tenant databases
• Dedicated TenantEntityManager service for runtime isolation

For full usage examples and advanced configuration, see the documentation.

🚀 Quick Installation

1. Via Symfony Flex (Recommended)

composer require hakam/multi-tenancy-bundle

Symfony Flex will automatically scaffold config, register the bundle, and create:

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

2. Manual Installation

composer require hakam/multi-tenancy-bundle

Then register in config/bundles.php, copy the example hakam_multi_tenancy.yaml from docs, and create the required directories.

🔗 Useful Links

• Full Documentation: [https://ramyhakam.github.io/multi_tenancy_bundle/]
• GitHub: https://github.com/RamyHakam/multi_tenancy_bundle
• Packagist: https://packagist.org/packages/hakam/multi-tenancy-bundle
• Example Project: https://github.com/RamyHakam/multi-tenancy-project-example

📄 License

MIT © Ramy Hakam