Skip to content

Více tenantů ​

Potřebujete to? ​

Tenanti jsou naCo udělat
vlastní doméně nebo subdoméně (acme.app.test)nic: každý origin má vlastní worker, cache i instalaci. Název a barvy řeší resolver manifestu.
cestách jedné domény (app.test/t/acme/)nastavit resolver tenantů (tato stránka)

Na sdílené doméně prohlížeč vidí jediný origin. Bez resolveru tenantů jsou všichni tenanti jedna nainstalovaná aplikace s jedním workerem a jednou sadou cache.

Resolver tenantů ​

php
use Illuminate\Http\Request;
use NyonCode\LaravelPwa\Contracts\TenantResolver;
use NyonCode\LaravelPwa\Tenancy\Tenant;

class PwaTenants implements TenantResolver
{
    // Tenant stránky, kterou uživatel otevřel.
    public function current(Request $request): ?Tenant
    {
        $team = $request->route('team');

        return $team ? $this->toTenant($team) : null;
    }

    // Tenant s tímto klíčem, pro routu manifestu (bez parametrů routy a bez session).
    public function find(string $key): ?Tenant
    {
        $team = Team::firstWhere('slug', $key);

        return $team ? $this->toTenant($team) : null;
    }

    private function toTenant(Team $team): Tenant
    {
        return new Tenant(
            key: $team->slug,
            scope: "/t/{$team->slug}/",
            startUrl: "/t/{$team->slug}/dashboard",
            name: $team->name,
        );
    }
}
php
// config/pwa.php
'tenancy' => ['resolver' => App\Pwa\PwaTenants::class],

// nebo v AppServiceProvider::boot()
Pwa::resolveTenantsUsing(PwaTenants::class);
Argument TenantPravidla
key1–64 písmen, číslic, -, _; veřejný (je v URL manifestu)
scopecesta s lomítkem na začátku i na konci, např. /t/acme/
startUrluvnitř scope; výchozí je scope
name, shortNamevolitelný název v manifestu; shortName je výchozí name

find() dostává klíč z query stringu: pro neznámý klíč vraťte null a nikdy nevracejte tenanta, kterého klíč nejmenuje.

Co se na stránce tenanta změní ​

  • <x-pwa::head/> zaregistruje stejný /sw.js pro scope tenanta, takže každý tenant má vlastní registraci workeru i cyklus aktualizací.
  • Odkaz na manifest dostane ?tenant={key}; manifest pak má id, scope, start_url a name tenanta, takže se každý tenant instaluje jako samostatná aplikace. Vaše resolvery běží až po tomto a mohou změnit cokoli dalšího (ikony, barvy).
  • Worker pojmenuje cache podle svého scope, pwa-@{slug}.{hash}-…, například pwa-@t-acme.7e36a372-pages-{user}. Hash přesné cesty scope drží podobné cesty (/t/a-b/, /t/a/b/) od sebe. Worker pro pwa.scope si nechá prosté názvy (pwa-pages-{user}) a žádný worker nemaže precache jiného workeru.
  • Stránky mimo všechny tenanty mají výchozí scope a manifest.

Co zůstává společné pro celý origin:

SpolečnéProč to nevadí
přihlášený uživatelpřihlášení nebo odhlášení, které uvidí jeden worker, smaže data uživatele u všech tenantů najednou a dá vědět ostatním workerům (BroadcastChannel)
fronta offline akcí (IndexedDB pwa)požadavky ve frontě mají absolutní URL téhož uživatele; odeslat je může kterýkoli worker a změna uživatele ji vyprázdní
nouzové vypnutípwa:disable je nouzová brzda pro celý origin
odhlášeníClear-Site-Data: "cache" smaže cache všech tenantů

stancl/tenancy ​

S identifikací podle cesty (InitializeTenancyByPath, routy s prefixem /{tenant}):

php
class PwaTenants implements TenantResolver
{
    public function current(Request $request): ?Tenant
    {
        return tenancy()->initialized ? $this->toTenant(tenant()) : null;
    }

    public function find(string $key): ?Tenant
    {
        $tenant = \App\Models\Tenant::find($key);

        return $tenant ? $this->toTenant($tenant) : null;
    }

    private function toTenant($tenant): Tenant
    {
        return new Tenant(key: $tenant->getTenantKey(), scope: "/{$tenant->getTenantKey()}/", name: $tenant->name);
    }
}

Routa manifestu běží mimo tenancy middleware, takže find() musí tenanta dohledat sám.

spatie/laravel-multitenancy ​

php
use Spatie\Multitenancy\Models\Tenant as SpatieTenant;

class PwaTenants implements TenantResolver
{
    public function current(Request $request): ?Tenant
    {
        $tenant = SpatieTenant::current();

        return $tenant ? $this->toTenant($tenant) : null;
    }

    public function find(string $key): ?Tenant
    {
        $tenant = SpatieTenant::firstWhere('slug', $key);

        return $tenant ? $this->toTenant($tenant) : null;
    }

    private function toTenant(SpatieTenant $tenant): Tenant
    {
        return new Tenant(key: $tenant->slug, scope: "/{$tenant->slug}/", name: $tenant->name);
    }
}

S výchozím vyhledáváním podle domény jsou tenanti na samostatných originech a resolver tenantů nepotřebujete.

Testování ​

php
$this->get('/t/acme/dashboard')->assertSee('manifest.webmanifest?tenant=acme', false);

$this->get('/manifest.webmanifest?tenant=acme')
    ->assertJson(['id' => '/t/acme/', 'scope' => '/t/acme/'])
    ->assertValidManifest();

pwa:doctor ohlásí, jestli jde nastavený resolver sestavit.

Released under the MIT License.