Add identification section to config, refactor static properties

src/Controllers/TenantAssetController.php

@@ -4,18 +4,16 @@ declare(strict_types=1);
 
 namespace Stancl\Tenancy\Controllers;
 
-use Closure;
 use Illuminate\Routing\Controller;
+use Stancl\Tenancy\Tenancy;
 use Symfony\Component\HttpFoundation\BinaryFileResponse;
 use Throwable;
 
-class TenantAssetsController extends Controller // todo rename this to TenantAssetController & update references in docs
+class TenantAssetController extends Controller // todo@docs this was renamed from TenantAssetsController
 {
-    public static string|array|Closure $tenancyMiddleware = \Stancl\Tenancy\Middleware\InitializeTenancyByDomain::class;
-
     public function __construct()
     {
-        $this->middleware(static::$tenancyMiddleware);
+        $this->middleware(Tenancy::defaultMiddleware());
     }
 
     /**

src/Database/Concerns/InvalidatesResolverCache.php

@@ -5,22 +5,15 @@ declare(strict_types=1);
 namespace Stancl\Tenancy\Database\Concerns;
 
 use Stancl\Tenancy\Contracts\Tenant;
-use Stancl\Tenancy\Resolvers;
 use Stancl\Tenancy\Resolvers\Contracts\CachedTenantResolver;
+use Stancl\Tenancy\Tenancy;
 
 trait InvalidatesResolverCache
 {
-    /** @var array<class-string<CachedTenantResolver>> */
-    public static $resolvers = [ // todo@deprecated, move this to a config key? related to a todo in InvalidatesTenantsResolverCache
-        Resolvers\DomainTenantResolver::class,
-        Resolvers\PathTenantResolver::class,
-        Resolvers\RequestDataTenantResolver::class,
-    ];
-
     public static function bootInvalidatesResolverCache(): void
     {
         static::saved(function (Tenant $tenant) {
-            foreach (static::$resolvers as $resolver) {
+            foreach (Tenancy::cachedResolvers() as $resolver) {
                 /** @var CachedTenantResolver $resolver */
                 $resolver = app($resolver);
 

src/Database/Concerns/InvalidatesTenantsResolverCache.php

@@ -5,25 +5,18 @@ declare(strict_types=1);
 namespace Stancl\Tenancy\Database\Concerns;
 
 use Illuminate\Database\Eloquent\Model;
-use Stancl\Tenancy\Resolvers;
 use Stancl\Tenancy\Resolvers\Contracts\CachedTenantResolver;
+use Stancl\Tenancy\Tenancy;
 
 /**
  * Meant to be used on models that belong to tenants.
  */
 trait InvalidatesTenantsResolverCache
 {
-    /** @var array<class-string<CachedTenantResolver>> */
-    public static array $resolvers = [ // todo single source of truth for this here and in InvalidatesResolverCache
-        Resolvers\DomainTenantResolver::class,
-        Resolvers\PathTenantResolver::class,
-        Resolvers\RequestDataTenantResolver::class,
-    ];
-
     public static function bootInvalidatesTenantsResolverCache(): void
     {
         static::saved(function (Model $model) {
-            foreach (static::$resolvers as $resolver) {
+            foreach (Tenancy::cachedResolvers() as $resolver) {
                 /** @var CachedTenantResolver $resolver */
                 $resolver = app($resolver);
 

src/Exceptions/RouteIsMissingTenantParameterException.php

@@ -11,7 +11,7 @@ class RouteIsMissingTenantParameterException extends Exception
 {
     public function __construct()
     {
-        $parameter = PathTenantResolver::$tenantParameterName;
+        $parameter = PathTenantResolver::tenantParameterName();
 
         parent::__construct("The route's first argument is not the tenant id (configured paramter name: $parameter).");
     }

src/Middleware/InitializeTenancyByPath.php

@@ -34,14 +34,8 @@ class InitializeTenancyByPath extends IdentificationMiddleware
         // Only initialize tenancy if tenant is the first parameter
         // We don't want to initialize tenancy if the tenant is
         // simply injected into some route controller action.
-        if ($route->parameterNames()[0] === PathTenantResolver::$tenantParameterName) {
-            // Set tenant as a default parameter for the URLs in the current request
-            Event::listen(InitializingTenancy::class, function (InitializingTenancy $event) {
-                /** @var Tenant $tenant */
-                $tenant = $event->tenancy->tenant;
-
-                URL::defaults([PathTenantResolver::$tenantParameterName => $tenant->getTenantKey()]);
-            });
+        if ($route->parameterNames()[0] === PathTenantResolver::tenantParameterName()) {
+            $this->setDefaultTenantForRouteParametersWhenTenancyIsInitialized();
 
             return $this->initializeTenancy(
                 $request,
@@ -54,4 +48,16 @@ class InitializeTenancyByPath extends IdentificationMiddleware
 
         return $next($request);
     }
+
+    protected function setDefaultTenantForRouteParametersWhenTenancyIsInitialized(): void
+    {
+        Event::listen(InitializingTenancy::class, function (InitializingTenancy $event) {
+            /** @var Tenant $tenant */
+            $tenant = $event->tenancy->tenant;
+
+            URL::defaults([
+                PathTenantResolver::tenantParameterName() => $tenant->getTenantKey(),
+            ]);
+        });
+    }
 }

src/Resolvers/Contracts/CachedTenantResolver.php

@@ -11,23 +11,17 @@ use Stancl\Tenancy\Contracts\TenantResolver;
 
 abstract class CachedTenantResolver implements TenantResolver
 {
-    public static bool $shouldCache = false; // todo docblocks for these
-
-    public static int $cacheTTL = 3600; // seconds
-
-    public static string|null $cacheStore = null; // default
-
     /** @var Repository */
     protected $cache;
 
     public function __construct(Factory $cache)
     {
-        $this->cache = $cache->store(static::$cacheStore);
+        $this->cache = $cache->store(static::cacheStore());
     }
 
     public function resolve(mixed ...$args): Tenant
     {
-        if (! static::$shouldCache) {
+        if (! static::shouldCache()) {
             return $this->resolveWithoutCache(...$args);
         }
 
@@ -42,14 +36,14 @@ abstract class CachedTenantResolver implements TenantResolver
         }
 
         $tenant = $this->resolveWithoutCache(...$args);
-        $this->cache->put($key, $tenant, static::$cacheTTL);
+        $this->cache->put($key, $tenant, static::cacheTTL());
 
         return $tenant;
     }
 
     public function invalidateCache(Tenant $tenant): void
     {
-        if (! static::$shouldCache) {
+        if (! static::shouldCache()) {
             return;
         }
 
@@ -75,4 +69,19 @@ abstract class CachedTenantResolver implements TenantResolver
      * @return array[]
      */
     abstract public function getArgsForTenant(Tenant $tenant): array;
+
+    public static function shouldCache(): bool
+    {
+        return config('tenancy.identification.resolvers.' . static::class . '.cache') ?? false;
+    }
+
+    public static function cacheTTL(): int
+    {
+        return config('tenancy.identification.resolvers.' . static::class . '.cache_ttl') ?? 3600;
+    }
+
+    public static function cacheStore(): string|null
+    {
+        return config('tenancy.identification.resolvers.' . static::class . '.cache_store');
+    }
 }

src/Resolvers/DomainTenantResolver.php

@@ -14,12 +14,6 @@ class DomainTenantResolver extends Contracts\CachedTenantResolver
     /** The model representing the domain that the tenant was identified on. */
     public static Domain $currentDomain; // todo |null?
 
-    public static bool $shouldCache = false;
-
-    public static int $cacheTTL = 3600; // seconds
-
-    public static string|null $cacheStore = null; // default
-
     public function resolveWithoutCache(mixed ...$args): Tenant
     {
         $domain = $args[0];

src/Resolvers/PathTenantResolver.php

@@ -10,21 +10,13 @@ use Stancl\Tenancy\Exceptions\TenantCouldNotBeIdentifiedByPathException;
 
 class PathTenantResolver extends Contracts\CachedTenantResolver
 {
-    public static string $tenantParameterName = 'tenant';
-
-    public static bool $shouldCache = false;
-
-    public static int $cacheTTL = 3600; // seconds
-
-    public static string|null $cacheStore = null; // default
-
     public function resolveWithoutCache(mixed ...$args): Tenant
     {
         /** @var Route $route */
         $route = $args[0];
 
-        if ($id = (string) $route->parameter(static::$tenantParameterName)) {
-            $route->forgetParameter(static::$tenantParameterName);
+        if ($id = (string) $route->parameter(static::tenantParameterName())) {
+            $route->forgetParameter(static::tenantParameterName());
 
             if ($tenant = tenancy()->find($id)) {
                 return $tenant;
@@ -40,4 +32,9 @@ class PathTenantResolver extends Contracts\CachedTenantResolver
             [$tenant->getTenantKey()],
         ];
     }
+
+    public static function tenantParameterName(): string
+    {
+        return config('tenancy.identification.resolvers.' . static::class . '.tenant_parameter_name') ?? 'tenant';
+    }
 }

src/Tenancy.php

@@ -42,7 +42,7 @@ class Tenancy
             }
         }
 
-        // todo0 for phpstan this should be $this->tenant?, but first I want to clean up the $initialized logic and explore removing the property
+        // todo1 for phpstan this should be $this->tenant?, but first I want to clean up the $initialized logic and explore removing the property
         if ($this->initialized && $this->tenant->getTenantKey() === $tenant->getTenantKey()) {
             return;
         }
@@ -157,7 +157,7 @@ class Tenancy
         $tenants = is_string($tenants) ? [$tenants] : $tenants;
 
         // Use all tenants if $tenants is falsey
-        $tenants = $tenants ?: $this->model()->cursor(); // todo0 phpstan thinks this isn't needed, but tests fail without it
+        $tenants = $tenants ?: $this->model()->cursor(); // todo1 phpstan thinks this isn't needed, but tests fail without it
 
         $originalTenant = $this->tenant;
 
@@ -177,4 +177,41 @@ class Tenancy
             $this->end();
         }
     }
+
+    /**
+     * Cached tenant resolvers used by the package.
+     *
+     * @return array<class-string<Resolvers\Contracts\CachedTenantResolver>>
+     */
+    public static function cachedResolvers(): array
+    {
+        $resolvers = config('tenancy.identification.resolvers', []);
+
+        $cachedResolvers = array_filter($resolvers, function (array $options) {
+            // Resolvers based on CachedTenantResolver have the 'cache' option in the resolver config
+            return isset($options['cache']);
+        });
+
+        return array_keys($cachedResolvers);
+    }
+
+    /**
+     * Tenant identification middleware used by the package.
+     *
+     * @return array<class-string<Middleware\IdentificationMiddleware>>
+     */
+    public static function middleware(): array
+    {
+        return config('tenancy.identification.middleware', []);
+    }
+
+    /**
+     * Default tenant identification middleware used by the package.
+     *
+     * @return class-string<Middleware\IdentificationMiddleware>
+     */
+    public static function defaultMiddleware(): string
+    {
+        return config('tenancy.identification.default_middleware', Middleware\InitializeTenancyByDomain::class);
+    }
 }

src/TenancyServiceProvider.php

@@ -120,7 +120,7 @@ class TenancyServiceProvider extends ServiceProvider
             if ($event instanceof TenancyEvent) {
                 match (tenancy()->logMode()) {
                     LogMode::SILENT => tenancy()->logEvent($event),
-                    LogMode::INSTANT => dump($event), // todo0 perhaps still log
+                    LogMode::INSTANT => dump($event), // todo1 perhaps still log
                     default => null,
                 };
             }