PHPackages                             sbine/simple-tenancy - 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. sbine/simple-tenancy

ActiveLibrary[Utility & Helpers](/categories/utility)

sbine/simple-tenancy
====================

Simple Laravel multi-tenancy in the same database

0.0.7(1y ago)373.7k5MITPHPPHP ^8.2CI passing

Since Jan 12Pushed 1y ago2 watchersCompare

[ Source](https://github.com/sbine/simple-tenancy)[ Packagist](https://packagist.org/packages/sbine/simple-tenancy)[ RSS](/packages/sbine-simple-tenancy/feed)WikiDiscussions main Synced 2w ago

READMEChangelogDependencies (2)Versions (8)Used By (0)

Simple Laravel Multi-Tenancy
============================

[](#simple-laravel-multi-tenancy)

[![Build status](https://camo.githubusercontent.com/9c54fa30cd7ad5f166abd9b978b9d993de988bb7ba73835262a66d11dce7611a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f7362696e652f73696d706c652d74656e616e63792f74657374732e796d6c3f6272616e63683d6d61696e)](https://camo.githubusercontent.com/9c54fa30cd7ad5f166abd9b978b9d993de988bb7ba73835262a66d11dce7611a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f7362696e652f73696d706c652d74656e616e63792f74657374732e796d6c3f6272616e63683d6d61696e)

Simple Tenancy adds automatic multi-tenant support to Eloquent models stored in a shared database.

It requires zero configuration in most cases, relying on established Laravel conventions and a single column on each table.

### How it works

[](#how-it-works)

Under the hood, it has only 4 components:

1. `Tenant`: Keeps track of the current user
2. `HasTenancy`: A trait for models belonging to the tenant, which registers:
3. `TenancyScope`: A [global scope](https://laravel.com/docs/master/eloquent#global-scopes) limiting all the model's queries to the current tenant
4. `TenancyObserver`: An [observer](https://laravel.com/docs/master/eloquent#observers) which sets the current tenant column/identifier on save

By default, the tenant is Laravel's `Auth::user()`, and all tenancy checks are disabled when no one is authenticated.

Installation
------------

[](#installation)

1. Install using Composer:

```
composer require sbine/simple-tenancy
```

2. Add the `HasTenancy` trait to all models belonging to the tenant:

```
class Account extends Model
{
    use \Sbine\Tenancy\HasTenancy;
}
```

3. Ensure a `user_id` column exists on the table of every model using the trait.

Customizing the tenant column/ID
--------------------------------

[](#customizing-the-tenant-columnid)

If needed, you can customize the name of the tenant column or identifier by extending the Tenant class and [binding it into the container](#customizing-tenancy-behavior):

```
class MyTenant extends \Sbine\Tenancy\Tenant
{
    /**
     * Retrieve the column identifying each model's tenant.
     */
    public function column()
    {
        return 'tenant_hashid';
    }

    /**
     * Retrieve the current tenant's identifier.
     */
    public function id()
    {
        return $this->user->hashid;
    }
}
```

Customizing tenancy behavior
----------------------------

[](#customizing-tenancy-behavior)

By default, if no user is authenticated tenancy will be completely disabled. This is by design so the library doesn't interfere with testing, seeding, and other unauthenticated model usage.

To change the tenancy behavior in any way, you can override the Tenant binding in the application container.

For example, to prevent all querying and saving of tenant models when no one is authenticated:

```
    // In AppServiceProvider.php
    public function register()
    {
        $this->app->singleton(\Sbine\Tenancy\Tenant::class, function () {
            // Throw an AuthenticationException if auth check fails
            return new \Sbine\Tenancy\Tenant(Auth::authenticate());
        });
    }
```

To allow overriding tenancy checks based on a policy or method, pass a callback returning `true` or `false`:

```
    // In AppServiceProvider.php
    public function register()
    {
        $this->app->singleton(\Sbine\Tenancy\Tenant::class, function () {
            return new \Sbine\Tenancy\Tenant(Auth::user(), function ($user) {
                return $user->can('admin');
            });
        });
    }
```

For complete control over tenant behavior, you can bind your own Tenant implementation:

```
    // In AppServiceProvider.php
    public function register()
    {
        $this->app->singleton(\Sbine\Tenancy\Tenant::class, function () {
            return new MyTenant;
        });
    }
```

Disabling tenancy
-----------------

[](#disabling-tenancy)

For convenience, a SuperAdmin class is provided which you can bind at any time to disable tenant checks:

```
    $this->app->singleton(\Sbine\Tenancy\Tenant::class, \Sbine\Tenancy\SuperAdmin::class);
```

###  Health Score

42

—

FairBetter than 88% of packages

Maintenance45

Moderate activity, may be stable

Popularity32

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

Top contributor holds 87.1% 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 ~330 days

Recently: every ~425 days

Total

7

Last Release

426d ago

PHP version history (5 changes)0.0.1PHP ^7.2

0.0.3PHP ^7.3

0.0.5PHP ^7.3 || ^8.0

0.0.6PHP ^7.4 || ^8.0

0.0.7PHP ^8.2

### Community

Maintainers

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

---

Top Contributors

[![sbine](https://avatars.githubusercontent.com/u/1902973?v=4)](https://github.com/sbine "sbine (27 commits)")[![ryanwohara](https://avatars.githubusercontent.com/u/5102611?v=4)](https://github.com/ryanwohara "ryanwohara (4 commits)")

---

Tags

hacktoberfestlaravelmulti-tenancylaravelSimplemultitenancy

### Embed Badge

![Health badge](/badges/sbine-simple-tenancy/health.svg)

```
[![Health](https://phpackages.com/badges/sbine-simple-tenancy/health.svg)](https://phpackages.com/packages/sbine-simple-tenancy)
```

###  Alternatives

[markwalet/nova-modal-response

A Laravel Nova asset for Modal responses on an action.

17930.8k](/packages/markwalet-nova-modal-response)[api-platform/laravel

API Platform support for Laravel

58190.1k21](/packages/api-platform-laravel)[ronasit/laravel-helpers

Provided helpers function and some helper class.

2087.0k31](/packages/ronasit-laravel-helpers)[team-nifty-gmbh/tall-datatables

Server-side rendered datatables for Laravel and Livewire

1422.0k5](/packages/team-nifty-gmbh-tall-datatables)[crumbls/layup

A visual page builder plugin for Filament 5 — Divi-style grid layouts with extensible widgets.

604.0k2](/packages/crumbls-layup)[tomshaw/electricgrid

A feature-rich Livewire package designed for projects that require dynamic, interactive data tables.

119.8k](/packages/tomshaw-electricgrid)

PHPackages © 2026

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