PHPackages                             phariscope/multitenant - 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. [Utility & Helpers](/categories/utility)
4. /
5. phariscope/multitenant

ActiveSymfony-bundle[Utility & Helpers](/categories/utility)

phariscope/multitenant
======================

Multitenant components.

0.0.14(10mo ago)11.1k↓50%[1 PRs](https://github.com/phariscope/MultiTenant/pulls)MITPHPPHP >=8.2

Since Sep 18Pushed 7mo agoCompare

[ Source](https://github.com/phariscope/MultiTenant)[ Packagist](https://packagist.org/packages/phariscope/multitenant)[ Docs](https://github.com/phariscope/MultiTenant)[ RSS](/packages/phariscope-multitenant/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (15)Versions (20)Used By (0)

Multitenancy made easy for your projects
========================================

[](#multitenancy-made-easy-for-your-projects)

Easily add multitenancy capabilities to your Symfony projects without (too much) code modification.

Installation
============

[](#installation)

Prerequisites
-------------

[](#prerequisites)

We assume you have a DATA\_PATH environment variable to store all data, including database data and other data types such as files.

We assume you have a DATABASE\_URL environment variable containing the general path to your database.

Install
-------

[](#install)

Install the package using Composer:

```
composer require phariscope/multitenant
```

You can use Multitenant as a Symfony bundle. Simply add one line to your `config/bundles.php` file:

```
return [
    // other bundles

    Phariscope\MultiTenant\MultiTenantBundle::class => ['all' => true],
];
```

Usage
=====

[](#usage)

Use either the brute force or the precise method.

With the brute force method: Your entire application will be tenanted: it will be very difficult to implement any part external to your application, as the original DATA\_PATH and DATABASE\_URL env will be lost.

With the precise method: Choose where to implement tenant behavior or general behavior.

Brutal
------

[](#brutal)

Modify DATA\_PATH and DATABASE\_URL values as soon as possible with the ContextTransformer. You won't have to think about tenants anymore because your EntityManager object will be build with your tenant values.

For instance with Symfony, inside your console script or your index.php, just modify the contexte.

In a typical console script:

```
return function (array $context) {
    $o = new ContextTransformer($context);
    $o->transformDataPath();
    $o->transformDatabaseUrl();

    $kernel = new Kernel($context['APP_ENV'], (bool) $context['APP_DEBUG']);

    return new Application($kernel);
};
```

in your Symfony Commands YOU MUST allow --id\_tenant option like this

```
class YourOwnCommand extends Command
{
(...)

    protected function configure(): void
    {
        $this
            ->setName('my:own:command')
            ->setDescription('This is a sample command description.')
            ->addOption('tenant_id', null, InputOption::VALUE_REQUIRED, 'The ID of the tenant');
    }
(...)
```

Important : if you don't require tenant\_id then when you ignore --tenant\_id the orignal DATA\_PATH and DATABASE\_URL values are used. (so this is a way to have a global comportement; you can be "precise" anyway)

Precise
-------

[](#precise)

In a Symfony controller, follow these steps:

1. Inject `EntityManagerResolver` into your controller’s constructor.
2. Retrieve the tenant-specific entity manager within your route action.
3. create database and schema for a tenant if database does not exist for this tenant

For example, assuming you have a `tenant_id` in your request or session:

```
class YourController extends AbstractController
{
    public function __construct(
        private EntityManagerResolver $entityManagerResolver,
    ) {}

    #[Route('your/route', name: 'runYourRoute', methods: ['POST', 'GET'])]
    public function runYourRoute(Request $request): Response
    {
        $tenantEntityManager = $this->entityManagerResolver->getEntityManagerByRequest($request);
        (new DatabaseTools())->createDatabaseIfNotExists($entityManager);

        $repository = new YourSomeEntityDoctrineRepository($tenantEntityManager);

        // Your code here...
    }
}
```

Creating a Tenant Database
==========================

[](#creating-a-tenant-database)

Ensure you have the necessary console setup to handle tenant operations.

To create a database for a specific tenant (e.g., `tenantID1234`), you can use the console command:

```
bin/console tenant:database:create --tenant_id tenantID1234
```

Creating a Schema for a tenant database
=======================================

[](#creating-a-schema-for-a-tenant-database)

Once you have created a tenant database, you can create its schema.

You can use the console command:

```
bin/console tenant:schema:create --tenant_id tenantID1234
```

How it works
============

[](#how-it-works)

A "tenants" subfolder will be created in the DATA\_PATH. For each tenant, a specific folder will be created containing all the data, including the database.

For example:

```
DATA_PATH=./var/data
DATABASE_URL=sqlite:///%DATA_PATH%/eventually/some/subfolders/mydatabase.sqlite
```

Given the tenant "tenantID1234", the database create command will create the following file: ./var/data/tenants/tenantID1234/eventually/some/subfolders/mydatabase.sqlite

The "./var/data/tenants/tenantID1234" folder will contain all the data required for your project.

###  Health Score

37

—

LowBetter than 83% of packages

Maintenance58

Moderate activity, may be stable

Popularity20

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~20 days

Recently: every ~0 days

Total

16

Last Release

305d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/b55e08523b4e1c881655796925ea5ac3ed5d997b533185be986b4a0e0d4f73c4?d=identicon)[fredlogipro](/maintainers/fredlogipro)

---

Top Contributors

[![frederic100](https://avatars.githubusercontent.com/u/50176793?v=4)](https://github.com/frederic100 "frederic100 (40 commits)")

---

Tags

tenantmulti-tenantmultitenant

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/phariscope-multitenant/health.svg)

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

###  Alternatives

[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

595.2M386](/packages/shopware-core)[ec-cube/ec-cube

EC-CUBE EC open platform.

78527.0k1](/packages/ec-cube-ec-cube)[flarum/core

Delightfully simple forum software.

211.3M1.9k](/packages/flarum-core)[mapbender/mapbender

Mapbender library

10117.4k5](/packages/mapbender-mapbender)[chameleon-system/chameleon-base

The Chameleon System core.

1026.5k3](/packages/chameleon-system-chameleon-base)

PHPackages © 2026

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