PHPackages                             uendelsilveira/laravel-tenant-core - 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. uendelsilveira/laravel-tenant-core

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

uendelsilveira/laravel-tenant-core
==================================

Infrastructure-only multi-tenant multi-database package for Laravel

v1.6.0(4mo ago)06MITPHPPHP ^8.2CI passing

Since Jan 5Pushed 4mo agoCompare

[ Source](https://github.com/uendelsilveira/laravel-tenant-core)[ Packagist](https://packagist.org/packages/uendelsilveira/laravel-tenant-core)[ Docs](https://github.com/uendelsilveira/laravel-tenant-core)[ RSS](/packages/uendelsilveira-laravel-tenant-core/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (7)Dependencies (9)Versions (8)Used By (0)

Laravel Tenant Core
===================

[](#laravel-tenant-core)

Infrastructure-only multi-tenant package for Laravel using a multi-database approach.

Features
--------

[](#features)

- Multi-database architecture (one database per tenant)
- Multiple tenant resolvers (subdomain, path, header)
- Middleware groups for tenant and central routes
- Event-driven lifecycle (TenantResolved, TenantBooted, TenantEnded)
- Built-in caching and Laravel Octane support
- Infrastructure only - no authentication, authorization, or UI

Requirements
------------

[](#requirements)

- PHP 8.2+
- Laravel 10.x, 11.x, or 12.x
- MySQL, PostgreSQL, or SQLite

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

[](#installation)

```
composer require uendelsilveira/laravel-tenant-core
```

**Publish all assets:**

```
php artisan vendor:publish --provider="UendelSilveira\\TenantCore\\Providers\\TenantServiceProvider"
```

This publishes:

- Configuration (`config/tenant.php`)
- Migrations (central and tenant)
- Models (`Tenant`, `Domain`, `SystemUser`)
- Routes (`routes/tenant.php`, `routes/central.php`)
- Seeders (example tenant and SuperAdmin)

**Configure your `.env`:**

```
DB_DATABASE_CENTRAL=central

TENANT_CENTRAL_DOMAIN=localhost
TENANT_CONNECTION_CENTRAL=central
TENANT_CONNECTION_TENANT=tenant
TENANT_RESOLVER=subdomain
```

> ⚠️ **Important:** Move Laravel's default migrations to `database/migrations/central/` as they use the central database. See [Installation Guide](docs/INSTALLATION.md) for details.

**For detailed installation instructions, see [docs/INSTALLATION.md](docs/INSTALLATION.md)**

Artisan Commands
----------------

[](#artisan-commands)

The package includes powerful commands to manage tenants:

```
php artisan tenant:list              # List all tenants
php artisan tenant:create "Company"  # Create new tenant
php artisan tenant:migrate           # Run migrations for all tenants
php artisan tenant:migrate:fresh     # Fresh migrations
php artisan tenant:migrate:rollback  # Rollback migrations
php artisan tenant:seed              # Seed tenant databases
php artisan tenant:run {command}     # Run any Artisan command for tenants
```

See [Installation Guide](docs/INSTALLATION.md) for detailed command usage.

Usage
-----

[](#usage)

**Tenant Routes:**

```
Route::middleware('tenant')->group(function () {
    Route::get('/dashboard', [DashboardController::class, 'index']);
});
```

**Central Routes:**

```
Route::middleware('central')->group(function () {
    Route::get('/admin', [AdminController::class, 'index']);
});
```

**Helpers:**

```
$tenant = tenant_current();  // Get current tenant
$id = tenant_key();          // Get tenant ID
$slug = tenant_slug();       // Get tenant slug

is_tenant();   // Check if in tenant context
is_central();  // Check if in central context
```

**Events:**

- `TenantResolved` - Tenant identified
- `TenantBooted` - Database connected
- `TenantEnded` - Context cleared

Testing
-------

[](#testing)

```
composer test
```

License
-------

[](#license)

The MIT License (MIT). See [LICENSE](LICENSE) for details.

Author
------

[](#author)

**Uendel Silveira** -

[LinkedIn](https://linkedin.com/in/uendelsilveira) • [GitHub](https://github.com/uendelsilveira)

###  Health Score

36

—

LowBetter than 82% of packages

Maintenance77

Regular maintenance activity

Popularity4

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

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 ~0 days

Total

7

Last Release

127d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/9297d8e7fe16b509423d16efb4959688388743af689ddd494cd560806c6366af?d=identicon)[uendelsilveira](/maintainers/uendelsilveira)

---

Tags

laravelsaastenantmulti-tenantmulti-tenancymulti-database

###  Code Quality

TestsPHPUnit

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/uendelsilveira-laravel-tenant-core/health.svg)

```
[![Health](https://phpackages.com/badges/uendelsilveira-laravel-tenant-core/health.svg)](https://phpackages.com/packages/uendelsilveira-laravel-tenant-core)
```

###  Alternatives

[laravel/pulse

Laravel Pulse is a real-time application performance monitoring tool and dashboard for your Laravel application.

1.7k12.1M99](/packages/laravel-pulse)[psalm/plugin-laravel

Psalm plugin for Laravel

3274.9M308](/packages/psalm-plugin-laravel)[roots/acorn

Framework for Roots WordPress projects built with Laravel components.

9682.1M97](/packages/roots-acorn)[hyn/multi-tenant

Run multiple websites using the same laravel installation while keeping tenant specific data separated for fully independant multi-domain setups.

2.6k1.1M9](/packages/hyn-multi-tenant)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

255.2k](/packages/aedart-athenaeum)[bjuppa/laravel-blog

Add blog functionality to your Laravel project

483.3k2](/packages/bjuppa-laravel-blog)

PHPackages © 2026

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