mirror of
https://github.com/stancl/tenancy-docs.git
synced 2025-12-12 18:24:03 +00:00
63 lines
2.2 KiB
Markdown
63 lines
2.2 KiB
Markdown
---
|
||
title: Laravel Nova integration
|
||
extends: _layouts.documentation
|
||
section: content
|
||
---
|
||
|
||
# Laravel Nova {#laravel-nova}
|
||
|
||
## In the central app
|
||
|
||
If you wish to use Laravel Nova in the central application (to manage tenants), you need to make a small change to the Nova migrations, they expect your model primary keys to always be unsigned big integers, but your tenants might be using `string` ids.
|
||
|
||
You can find the full Nova setup for managing tenants in the [SaaS boilerplate](/saas-boilerplate). It also implements Nova for **both the central and tenant parts of the app, with separate resources**.
|
||
|
||
## In the tenant app {#in-the-tenant-app}
|
||
|
||
To use Nova inside of the tenant part of your application, do the following:
|
||
|
||
- Publish the Nova migrations and move them to the `database/migrations/tenant` directory.
|
||
|
||
```
|
||
php artisan vendor:publish --tag=nova-migrations
|
||
```
|
||
|
||
- Prevent Nova from adding its migrations to your central migrations by adding `Nova::ignoreMigrations()` to `NovaServiceProvider::boot()` (Don't do this if you want to use Nova **[both in the central & tenant parts]({{ $page->link('features/universal-routes') }})** of the app.)
|
||
- Add the tenancy middleware to your `nova.middleware` config. Example:
|
||
|
||
```php
|
||
'middleware' => [
|
||
// You can make this simpler by creating a tenancy route group
|
||
InitializeTenancyByDomain::class,
|
||
PreventAccessFromCentralDomains::class,
|
||
'web',
|
||
Authenticate::class,
|
||
DispatchServingNovaEvent::class,
|
||
BootTools::class,
|
||
Authorize::class,
|
||
],
|
||
```
|
||
- In your `NovaServiceProvider`'s `routes()` method, replace the following lines:
|
||
|
||
```php
|
||
->withAuthenticationRoutes()
|
||
->withPasswordResetRoutes()
|
||
```
|
||
|
||
with these lines:
|
||
|
||
```php
|
||
->withAuthenticationRoutes([
|
||
// You can make this simpler by creating a tenancy route group
|
||
InitializeTenancyByDomain::class,
|
||
PreventAccessFromCentralDomains::class,
|
||
'web',
|
||
])
|
||
->withPasswordResetRoutes([
|
||
// You can make this simpler by creating a tenancy route group
|
||
InitializeTenancyByDomain::class,
|
||
PreventAccessFromCentralDomains::class,
|
||
'web',
|
||
])
|
||
```
|
||
- Set the `domain` in Nova config to `null`
|