spatie/laravel-multitenancy

What's Changed

Processing a job no longer leaves the surrounding code with a different current tenant than it had before (#639, #643).

On the sync connection and through dispatchSync(), a job runs inside the request that dispatched it. A job that is not tenant aware forgot the current tenant and never put it back, so the rest of the request continued without one. A tenant aware job for another tenant left that other tenant current. Whatever tenant was current before a job starts is now restored when it finishes, on both the success and the failure path, and nested sync dispatches restore per level.

queue:retry behaves the same way. It needs the tenant of a failed job while it pushes that job back onto the queue, but the tenant of the code that ran the command is restored once it finishes. This matters when retrying jobs from a request with Artisan::call('queue:retry').

Behaviour worth knowing about when upgrading: on a queue worker the tenant of a processed job no longer stays current after that job finishes. Every job binds its own tenant, so jobs are unaffected, but code reading Tenant::current() in between jobs now sees no tenant. Listeners that are part of processing a job, Queue::after() and JobFailed for instance, still see the tenant of the job they are handling.

• Update actions/checkout to v7 (#644)

Full Changelog: 4.1.5...4.2.0

What's Changed

Processing a job no longer leaves the surrounding code with a different current tenant than it had before (#639, #643).

On the sync connection and through dispatchSync(), a job runs inside the request that dispatched it. A job that is not tenant aware forgot the current tenant and never put it back, so the rest of the request continued without one. A tenant aware job for another tenant left that other tenant current. Whatever tenant was current before a job starts is now restored when it finishes, on both the success and the failure path, and nested sync dispatches restore per level.

queue:retry behaves the same way. It needs the tenant of a failed job while it pushes that job back onto the queue, but the tenant of the code that ran the command is restored once it finishes. This matters when retrying jobs from a request with Artisan::call('queue:retry').

Behaviour worth knowing about when upgrading: on a queue worker the tenant of a processed job no longer stays current after that job finishes. Every job binds its own tenant, so jobs are unaffected, but code reading Tenant::current() in between jobs now sees no tenant. Listeners that are part of processing a job, Queue::after() and JobFailed for instance, still see the tenant of the job they are handling.

• Update actions/checkout to v7 (#644)

Full Changelog: https://github.com/spatie/laravel-multitenancy/compare/4.1.5...4.2.0

What's Changed

• Fix tenant id retrival during job retry by @gazben in #642

Full Changelog: 4.1.4...4.1.5

What's Changed

• Fix tenant id retrival during job retry by @gazben in https://github.com/spatie/laravel-multitenancy/pull/642

Full Changelog: https://github.com/spatie/laravel-multitenancy/compare/4.1.4...4.1.5

What's Changed

• Support legacy queue payloads in tenant-awareness detection by @ragulka in #640

New Contributors

• @ragulka made their first contribution in #640

Full Changelog: 4.1.3...4.1.4

What's Changed

• Support legacy queue payloads in tenant-awareness detection by @ragulka in https://github.com/spatie/laravel-multitenancy/pull/640

New Contributors

• @ragulka made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/640

Full Changelog: https://github.com/spatie/laravel-multitenancy/compare/4.1.3...4.1.4

What's Changed

• Resolve tenant from payload context when retrying jobs by @freekmurze in #638

Full Changelog: 4.1.2...4.1.3

What's Changed

• Resolve tenant from payload context when retrying jobs by @freekmurze in https://github.com/spatie/laravel-multitenancy/pull/638

Full Changelog: https://github.com/spatie/laravel-multitenancy/compare/4.1.2...4.1.3

What's Changed

• Add Laravel Boost skill by @victoryoalli in #635

New Contributors

• @victoryoalli made their first contribution in #635

Full Changelog: 4.1.1...4.1.2

What's Changed

• Add Laravel Boost skill by @victoryoalli in https://github.com/spatie/laravel-multitenancy/pull/635

New Contributors

• @victoryoalli made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/635

Full Changelog: https://github.com/spatie/laravel-multitenancy/compare/4.1.1...4.1.2

What's Changed

• Add description to TenantsArtisanCommand by @dac514 in #633

New Contributors

• @dac514 made their first contribution in #633

Full Changelog: 4.1.0...4.1.1

What's Changed

• Add description to TenantsArtisanCommand by @dac514 in https://github.com/spatie/laravel-multitenancy/pull/633

New Contributors

• @dac514 made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/633

Full Changelog: https://github.com/spatie/laravel-multitenancy/compare/4.1.0...4.1.1

What's Changed

• Fix #617: Add default value for TasksCollection constructor parameter by @freekmurze in #625
• Fix #620: Handle JobRetryRequested in queue tenant awareness by @freekmurze in #624

Full Changelog: 4.0.8...4.0.9

What's Changed

• Fix #617: Add default value for TasksCollection constructor parameter by @freekmurze in https://github.com/spatie/laravel-multitenancy/pull/625
• Fix #620: Handle JobRetryRequested in queue tenant awareness by @freekmurze in https://github.com/spatie/laravel-multitenancy/pull/624

Full Changelog: https://github.com/spatie/laravel-multitenancy/compare/4.0.8...4.0.9

Co-Authored-By: Claude Opus 4.6 [email protected]

What's Changed

• Fix tenant context not being restored when exception occurs in execute() by @moisish in https://github.com/spatie/laravel-multitenancy/pull/622
• Bump minimum testbench to ^9.1.4 to fix $latestResponse error on prefer-lowest
• Fix notification test assertions for Laravel 11/12 compatibility

New Contributors

• @moisish made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/622

Full Changelog: https://github.com/spatie/laravel-multitenancy/compare/4.0.7...4.0.8

What's Changed

• Fix syntax for tenant aware interface config by @danharrin in #608

New Contributors

• @danharrin made their first contribution in #608

Full Changelog: 4.0.6...4.0.7

What's Changed

• Fix syntax for tenant aware interface config by @danharrin in https://github.com/spatie/laravel-multitenancy/pull/608

New Contributors

• @danharrin made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/608

Full Changelog: https://github.com/spatie/laravel-multitenancy/compare/4.0.6...4.0.7

What's Changed

• Command state persistence with TenantAware by @SethSharp in https://github.com/spatie/laravel-multitenancy/pull/602
• Add types to TenantCollection by @markieo1 in https://github.com/spatie/laravel-multitenancy/pull/596
• Update issue template by @AlexVanderbist in https://github.com/spatie/laravel-multitenancy/pull/603
• feat: Add configuration option to specify TenantAware and NotTenantAware interfaces by @przemyslaw-przylucki in https://github.com/spatie/laravel-multitenancy/pull/607

New Contributors

• @SethSharp made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/602
• @markieo1 made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/596
• @przemyslaw-przylucki made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/607

Full Changelog: https://github.com/spatie/laravel-multitenancy/compare/4.0.5...4.0.6

What's Changed

• Update using-multiple-databases.md by @najbo in https://github.com/spatie/laravel-multitenancy/pull/584
• [Bugfix]: Jobs with ShouldBeEncrypted need to be decrypted by @Joel-Jensen in https://github.com/spatie/laravel-multitenancy/pull/588

New Contributors

• @najbo made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/584
• @Joel-Jensen made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/588

Full Changelog: https://github.com/spatie/laravel-multitenancy/compare/4.0.4...4.0.5

What's Changed

• Laravel 12.x Compatibility by @laravel-shift in https://github.com/spatie/laravel-multitenancy/pull/580

Full Changelog: https://github.com/spatie/laravel-multitenancy/compare/4.0.3...4.0.4

What's Changed

• Docs: Fix formatting in interface code block by @inmanturbo in https://github.com/spatie/laravel-multitenancy/pull/560
• Show name of the job in the Exception by @michaelnabil230 in https://github.com/spatie/laravel-multitenancy/pull/570

New Contributors

• @michaelnabil230 made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/570

Full Changelog: https://github.com/spatie/laravel-multitenancy/compare/4.0.2...4.0.3

What's Changed

• Update using-a-custom-tenant-model.md by @thoresuenert in https://github.com/spatie/laravel-multitenancy/pull/553
• Fix an exception when requiring a tenant to be active to unserialize a model

New Contributors

• @thoresuenert made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/553

Full Changelog: https://github.com/spatie/laravel-multitenancy/compare/4.0.1...4.0.2

• Fix NotTenantAware notifications, mailables, closures, listeners & broadcast events in a default tenant aware application

Full Changelog: https://github.com/spatie/laravel-multitenancy/compare/4.0.0...4.0.1

What's Changed

• Refactor registerTenantFinder method to reduce complexity by @misaf in https://github.com/spatie/laravel-multitenancy/pull/536
• Contract IsTenant replace Tenant uses by @masterix21 in https://github.com/spatie/laravel-multitenancy/pull/544

New Contributors

• @misaf made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/536

Full Changelog: https://github.com/spatie/laravel-multitenancy/compare/3.2.0...4.0.0

What's Changed

• Laravel 11.x Compatibility by @laravel-shift in https://github.com/spatie/laravel-multitenancy/pull/522

New Contributors

• @laravel-shift made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/522

Full Changelog: https://github.com/spatie/laravel-multitenancy/compare/3.1.1...3.2.0

What's Changed

• Update migration stub by @sevannerse in https://github.com/spatie/laravel-multitenancy/pull/495
• Correct Typos by @jacobmllr95 in https://github.com/spatie/laravel-multitenancy/pull/501
• Add new TenantNotFoundForRequestEvent by @jacobmllr95 in https://github.com/spatie/laravel-multitenancy/pull/502

New Contributors

• @sevannerse made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/495
• @jacobmllr95 made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/501

Full Changelog: https://github.com/spatie/laravel-multitenancy/compare/3.1.0...3.1.1

What's Changed

• Add support to queued closures by @masterix21 in https://github.com/spatie/laravel-multitenancy/pull/492

Full Changelog: https://github.com/spatie/laravel-multitenancy/compare/3.0.3...3.1.0

What's Changed

• [no ci] Fix typo in config comment by @inmanturbo in https://github.com/spatie/laravel-multitenancy/pull/454
• [FIX] unmatched double quote (typo) by @inmanturbo in https://github.com/spatie/laravel-multitenancy/pull/459
• [FIX] Bind or forget current tenant by @raymadrona in https://github.com/spatie/laravel-multitenancy/pull/471

New Contributors

• @inmanturbo made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/454
• @raymadrona made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/471

Full Changelog: https://github.com/spatie/laravel-multitenancy/compare/3.0.2...3.0.3

What's Changed

• Fresh Tenant on each job by @masterix21 in https://github.com/spatie/laravel-multitenancy/pull/438

Full Changelog: https://github.com/spatie/laravel-multitenancy/compare/3.0.1...3.0.2

What's Changed

• Correct doc url version for v3 by @l3aro in https://github.com/spatie/laravel-multitenancy/pull/412
• docs: update composer command for install by @alexrififi in https://github.com/spatie/laravel-multitenancy/pull/413
• Add PHP 8.2 Support by @patinthehat in https://github.com/spatie/laravel-multitenancy/pull/424
• Update broken shield badge by @erikn69 in https://github.com/spatie/laravel-multitenancy/pull/437
• Laravel 10.x Support by @erikn69 in https://github.com/spatie/laravel-multitenancy/pull/435

New Contributors

• @l3aro made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/412
• @patinthehat made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/424
• @erikn69 made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/437

Full Changelog: https://github.com/spatie/laravel-multitenancy/compare/3.0.0...3.0.1

Breaking change

• NotTenantAware jobs will now forget any current tenant that might have been set when starting processing.

• Fix an issue where the Illuminate\Cache\Repository was not being cleared from the container

Full Changelog: https://github.com/spatie/laravel-multitenancy/compare/2.3.8...2.3.9

What's Changed

• Replace id with getKey() so uuids could be used as primary keys by @lartisan in https://github.com/spatie/laravel-multitenancy/pull/392

New Contributors

• @lartisan made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/392

Full Changelog: https://github.com/spatie/laravel-multitenancy/compare/2.3.7...2.3.8

What's Changed

• Prefix Cache Task - Cache Store by @moisish in https://github.com/spatie/laravel-multitenancy/pull/374

New Contributors

• @moisish made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/374

Full Changelog: https://github.com/spatie/laravel-multitenancy/compare/2.3.6...2.3.7

• docs: change method visibility in example by @medvinator in https://github.com/spatie/laravel-multitenancy/pull/326
• added ; in the php code by @MJunaidAhmad in https://github.com/spatie/laravel-multitenancy/pull/329
• Removing typehint for compatibility by @telkins in https://github.com/spatie/laravel-multitenancy/pull/336

Full Changelog: https://github.com/spatie/laravel-multitenancy/compare/2.3.2...2.3.3

• add support for Laravel 9

• Reload Router instance when switching route cache on Laravel Octane by @AlexVanderbist in https://github.com/spatie/laravel-multitenancy/pull/309

Full Changelog: https://github.com/spatie/laravel-multitenancy/compare/2.3.0...2.3.1

• Add route cache path switcher by @AlexVanderbist in https://github.com/spatie/laravel-multitenancy/pull/308

Full Changelog: https://github.com/spatie/laravel-multitenancy/compare/2.2.0...2.3.0

• Handle JobRetryRequested queue event and fix (#259)
• 🐛 tenants:artisan backslashes (#296)

• add filterCurrent and rejectCurrent to TenantCollection (#275)

• add Laravel Octane support

• drop support for PHP 7

• allow PHP 8

• NeedsTenant ability to return or redirect

• fix for BroadcastEvent (#142)

• add ability to dispatch events tenant aware

• add support for Laravel 8

• restored check isCurrent from makeCurrent

• 🐛 removed check isCurrent from makeCurrent

• forget current when making new tenant current

• removed $guarded from Tenant model

• TenantAware now uses the Tenant model from config

• TenantsArtisanCommand now uses TenantAware trait

• added TenantAware

• 🐛 properly handle queued mailables and notification (#78)

• database switch fails with misconfigured tenant (#92)

• added execute for the landlord

• added $tenant->execute($callable) to execute isolated tenant code (#60)

• tenant:artisan search field customizable using config (#52)

• allow mass assignment when creating a new tenant by default (#57)

• improve error handling of tenant aware jobs