archtechx/tenancy
1
0
Fork 0
mirror of https://github.com/archtechx/tenancy.git synced 2026-06-21 16:14:05 +00:00
Code Activity
tenancy/resources/boost/skills/laravel-tenancy/references/installation.md

2 KiB
Raw Blame History

Installation Reference

Use this when installing or auditing stancl/tenancy setup.

Source Files

  • src/Commands/Install.php
  • src/TenancyServiceProvider.php
  • assets/config.php
  • assets/tenant_routes.stub.php
  • assets/TenancyServiceProvider.stub.php
  • assets/migrations/*

Required Steps

  1. Install the package.
composer require stancl/tenancy
  1. Run the installer non-interactively.
php artisan tenancy:install --no-interaction
  1. Confirm these files exist:
  • config/tenancy.php
  • routes/tenant.php
  • app/Providers/TenancyServiceProvider.php
  • database/migrations/2019_09_15_000010_create_tenants_table.php
  • database/migrations/2019_09_15_000020_create_domains_table.php
  • database/migrations/tenant

  1. Review config/tenancy.php before running migrations.

  2. Run central migrations.

php artisan migrate

  1. Add tenant migrations to database/migrations/tenant.

  2. Create tenants and domains according to the identification strategy.

  3. Run tenant migrations.

php artisan tenants:migrate

Manual Publish Commands

Prefer tenancy:install. Use these only for targeted publishing:

php artisan vendor:publish --provider="Stancl\Tenancy\TenancyServiceProvider" --tag=config
php artisan vendor:publish --provider="Stancl\Tenancy\TenancyServiceProvider" --tag=routes
php artisan vendor:publish --provider="Stancl\Tenancy\TenancyServiceProvider" --tag=providers
php artisan vendor:publish --provider="Stancl\Tenancy\TenancyServiceProvider" --tag=migrations
php artisan vendor:publish --provider="Stancl\Tenancy\TenancyServiceProvider" --tag=impersonation-migrations
php artisan vendor:publish --provider="Stancl\Tenancy\TenancyServiceProvider" --tag=resource-syncing-migrations

Installer Behavior

  • Publishes config, routes, provider, and base migrations.
  • Creates database/migrations/tenant.
  • Skips files that already exist and warns instead of overwriting.
  • Shows an interactive support prompt unless --no-interaction is used.