📚 Full Documentation: https://ramyhakam.github.io/multi_tenancy_bundle/
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.
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/
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.
- 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
MIT © Ramy Hakam