Merge branch 'spatie:main' into feat-tenant-not-found-for-request-event

Author: jacobmllr95

config/multitenancy.php

@@ -22,7 +22,7 @@
     'tenant_finder' => null,
 
     /*
-     * These fields are used by tenant:artisan command to match one or more tenant
+     * These fields are used by tenant:artisan command to match one or more tenant.
      */
     'tenant_artisan_search_fields' => [
         'id',
@@ -61,7 +61,7 @@
     'tenant_database_connection_name' => null,
 
     /*
-     * The connection name to reach the landlord database
+     * The connection name to reach the landlord database.
      */
     'landlord_database_connection_name' => null,
 
@@ -88,7 +88,7 @@
     ],
 
     /*
-     * You can customize the way in which the package resolves the queuable to a job.
+     * You can customize the way in which the package resolves the queueable to a job.
      *
      * For example, using the package laravel-actions (by Loris Leiva), you can
      * resolve JobDecorator to getAction() like so: JobDecorator::class => 'getAction'

docs/advanced-usage/executing-code-for-tenants-and-landlords.md

@@ -14,7 +14,7 @@ Here is an example where we flush the cache for a tenant using our landlord API:
 ```php
 Route::delete('/api/{tenant}/flush-cache', function (Tenant $tenant) {
     $result = $tenant->execute(fn (Tenant $tenant) => cache()->flush());
-   
+
     return json_encode(["success" => $result]);
 });
 ```
@@ -25,12 +25,14 @@ Here's another example, where a job is dispatched from a landlord API route:
 
 ```php
 Route::post('/api/{tenant}/reminder', function (Tenant $tenant) {
-    return json_encode([ 
+    return json_encode([
         'data' => $tenant->execute(fn () => dispatch(ExpirationReminder())),
     ]);
 });
 ```
+
 ### Executing a delayed callback in the correct Tenant context
+
 If you need to define a callback that will be executed in the correct Tenant context every time it is called, you can use the Tenant's `callback` method.
 A notable example for this is the use in the Laravel scheduler where you can loop through all the tenants and schedule callbacks to be executed at the given time:
 
@@ -45,7 +47,7 @@ protected function schedule(Schedule $schedule)
 
 ## Executing landlord code in tenant request
 
-To execute landlord code, from inside a tenant request, you can use the method `execute` on `Spatie\Multitenancy\Landlord`. 
+To execute landlord code, from inside a tenant request, you can use the method `execute` on `Spatie\Multitenancy\Landlord`.
 
 Here is an example where we will first clear the tenant cache, and next, the landlord cache:
 
@@ -56,10 +58,10 @@ use  Spatie\Multitenancy\Landlord;
 
 Tenant::first()->execute(function (Tenant $tenant) {
     // it will clear the tenant cache
-    Artisan::call('cache:clear'); 
-   
+    Artisan::call('cache:clear');
+
     // it will clear the landlord cache
-    Landlord::execute(fn () => Artisan::call('cache:clear')); 
+    Landlord::execute(fn () => Artisan::call('cache:clear'));
 });
 ```
 
@@ -112,7 +114,7 @@ protected function setUp(): void
     Event::listen(MadeTenantCurrentEvent::class, function () {
         $this->beginDatabaseTransaction();
     });
-    
+
     Tenant::first()->makeCurrent();
 }
 ```

docs/advanced-usage/making-artisan-commands-tenant-aware.md

@@ -5,13 +5,13 @@ weight: 3
 
 Commands can be made tenant aware by applying the `TenantAware` trait. When using the trait it is required to append `{--tenant=*}` or `{--tenant=}` to the command signature.
 
-Caution: If you append `{--tenant=*}`, then if no `tenant` option is provided when executing the command, the command will execute for *all* tenants.
- 
+Caution: If you append `{--tenant=*}`, then if no `tenant` option is provided when executing the command, the command will execute for _all_ tenants.
+
 ```php
 use Illuminate\Console\Command;
 use Spatie\Multitenancy\Commands\Concerns\TenantAware;
 
-class YourFavouriteCommand extends Command
+class YourFavoriteCommand extends Command
 {
     use TenantAware;
 
@@ -24,18 +24,16 @@ class YourFavouriteCommand extends Command
 }
 ```
 
-When executing the command, the `handle` method will be called for each tenant. 
+When executing the command, the `handle` method will be called for each tenant.
 
 ```bash
-php artisan your-favorite-command 
+php artisan your-favorite-command
 ```
 
 Using the example above, the name of each tenant will be written to the output of the command.
 
-
 You can also execute the command for a specific tenant:
 
-
 ```bash
 php artisan your-favorite-command --tenant=1
 ```

docs/advanced-usage/using-tenant-specific-facades.md

@@ -7,7 +7,6 @@ Facades behave like singletons. They only resolve once, and each use of the faca
 
 If you only have a couple of tenant specific facade, we recommend only clearing them when switching a tenant. Here's a task that you could use for this.
 
-
 ```php
 namespace App\Tenancy\SwitchTasks;
 

docs/basic-usage/making-queues-tenant-aware.md

@@ -25,6 +25,7 @@ class TestJob implements ShouldQueue, TenantAware
 ```
 
 or, using the config `multitenancy.php`:
+
 ```php
 'tenant_aware_jobs' => [
     TestJob::class,
@@ -34,7 +35,7 @@ or, using the config `multitenancy.php`:
 ## Making specific jobs not tenant aware
 
 Jobs that never should be tenant aware should implement the empty marker interface `Spatie\Multitenancy\Jobs\NotTenantAware` or should be added to the config `not_tenant_aware_jobs`.
- 
+
 ```php
 use Illuminate\Contracts\Queue\ShouldQueue;
 use Spatie\Multitenancy\Jobs\NotTenantAware;
@@ -49,6 +50,7 @@ class TestJob implements ShouldQueue, NotTenantAware
 ```
 
 or, using the config `multitenancy.php`:
+
 ```php
 'not_tenant_aware_jobs' => [
     TestJob::class,

docs/basic-usage/working-with-the-current-tenant.md

@@ -37,7 +37,6 @@ $tenant->makeCurrent();
 
 When a tenant is made the current one, the package will run the `makeCurrent` method of [all tasks configured](/docs/laravel-multitenancy/v3/using-tasks-to-prepare-the-environment/overview/) in the `switch_tenant_tasks` key of the `multitenancy` config file.
 
-
 ### Forgetting the current tenant
 
 You can forget the current tenant:

docs/installation/base-installation.md

@@ -44,7 +44,7 @@ return [
     'tenant_finder' => null,
 
     /*
-     * These fields are used by tenant:artisan command to match one or more tenant
+     * These fields are used by tenant:artisan command to match one or more tenant.
      */
     'tenant_artisan_search_fields' => [
         'id',
@@ -83,7 +83,7 @@ return [
     'tenant_database_connection_name' => null,
 
     /*
-     * The connection name to reach the landlord database
+     * The connection name to reach the landlord database.
      */
     'landlord_database_connection_name' => null,
 
@@ -110,7 +110,7 @@ return [
     ],
 
     /*
-     * You can customize the way in which the package resolves the queuable to a job.
+     * You can customize the way in which the package resolves the queueable to a job.
      *
      * For example, using the package laravel-actions (by Loris Leiva), you can
      * resolve JobDecorator to getAction() like so: JobDecorator::class => 'getAction'

docs/installation/using-a-single-database.md

@@ -5,7 +5,7 @@ weight: 2
 
 Before using the following instructions, make sure you have performed [the base installation steps](/docs/laravel-multitenancy/v3/installation/base-installation) first.
 
- Only use the instructions on this page if you want to use one database.
+Only use the instructions on this page if you want to use one database.
 
 ### Migrating the database
 

docs/installation/using-multiple-databases.md

@@ -40,7 +40,6 @@ In the example below, the `mysql` driver is used, but you can use any driver you
     ],
 ```
 
-
 ### Migrating the landlord database
 
 With the database connection set up, we can migrate the landlord database.
@@ -101,7 +100,7 @@ php artisan tenants:artisan "migrate --database=tenant"
 If you want to have dedicated directory for tenant migrations (`database/migrations/tenant`) you can simply run:
 
 ```bash
-php artisan tenants:artisan "migrate --path=database/migrations/tenant --database=tenant" 
+php artisan tenants:artisan "migrate --path=database/migrations/tenant --database=tenant"
 ```
 
 ### Seeding tenant databases

docs/requirements.md

@@ -3,4 +3,4 @@ title: Requirements
 weight: 3
 ---
 
-This package requires **PHP 8.0+** and **Laravel 8.0+**. 
+This package requires **PHP 8.0+** and **Laravel 8.0+**.

docs/support-us.md

@@ -3,6 +3,6 @@ title: Support us
 weight: 2
 ---
 
-We invest a lot of resources into creating our [best in class open source packages](https://spatie.be/open-source). You can support us by [buying one of our paid products](https://spatie.be/open-source/support-us). 
+We invest a lot of resources into creating our [best in class open source packages](https://spatie.be/open-source). You can support us by [buying one of our paid products](https://spatie.be/open-source/support-us).
 
 We highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using. You'll find our address on [our contact page](https://spatie.be/about-us). We publish all received postcards on [our virtual postcard wall](https://spatie.be/open-source/postcards).

docs/using-tasks-to-prepare-the-environment/creating-your-own-task.md

@@ -82,7 +82,7 @@ use Spatie\Multitenancy\Tasks\SwitchTenantTask;
 class SwitchTenantDatabaseTask implements SwitchTenantTask
 {
     public function __construct(string $name, string $anotherName)
-    { 
+    {
         // do something
     }
 }
@@ -98,7 +98,7 @@ use Spatie\Multitenancy\Tasks\SwitchTenantTask;
 class SwitchTenantDatabaseTask implements SwitchTenantTask
 {
     public function __construct(string $name, string $anotherName, MyDepencency $myDependency)
-    { 
+    {
         // do something
     }
 }

docs/using-tasks-to-prepare-the-environment/overview.md

@@ -11,7 +11,7 @@ You can easily [create your own tasks](/docs/laravel-multitenancy/v3/using-tasks
 
 The package ships with these tasks:
 
-- [switch the tenant database](/docs/laravel-multitenancy/v3/using-tasks-to-prepare-the-environment/switching-databases) (required when using multiple tenant databases)
-- [prefixing the cache](/docs/laravel-multitenancy/v3/using-tasks-to-prepare-the-environment/prefixing-cache)
+-   [switch the tenant database](/docs/laravel-multitenancy/v3/using-tasks-to-prepare-the-environment/switching-databases) (required when using multiple tenant databases)
+-   [prefixing the cache](/docs/laravel-multitenancy/v3/using-tasks-to-prepare-the-environment/prefixing-cache)
 
 These tasks are optional. When you need one, just add it to the `switch_tenant_tasks` key of the `multitenancy` config file.

docs/using-tasks-to-prepare-the-environment/switching-route-cache-paths.md

@@ -32,6 +32,7 @@ In the default scenario, all tenants have different routes. The package creates
 It's the scenario where all tenants use the same routes. The package creates a shared route cache file for all tenants: `bootstrap/cache/routes-v7-tenants.php`.
 
 To enable the feature you should set to `true` the `shared_routes_cache` section of the `multitenancy` config file.
+
 ```php
 // in config/multitenancy.php