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 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 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 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 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 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 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

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.

What's Changed

• Convert all tests to PEST by @alexmanase in https://github.com/spatie/laravel-multitenancy/pull/405
• Forget tenant when job is not tenant aware by @riasvdv in https://github.com/spatie/laravel-multitenancy/pull/408

New Contributors

• @alexmanase made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/405
• @riasvdv made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/408

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

• 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

What's Changed

• Docs: fix the link to the video introduction by @PovilasKorop in https://github.com/spatie/laravel-multitenancy/pull/361
• Change return type hint for Tenant class from self to static by @ksassnowski in https://github.com/spatie/laravel-multitenancy/pull/365

New Contributors

• @PovilasKorop made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/361
• @ksassnowski made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/365

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

What's Changed

• Refresh connection resolver for models after switching database by @AlexVanderbist in https://github.com/spatie/laravel-multitenancy/pull/355
• Fix cache prefixes not being updated by @AlexVanderbist in https://github.com/spatie/laravel-multitenancy/pull/355
• Better compatibility with Octane

Full Changelog: https://github.com/spatie/laravel-multitenancy/compare/2.3.4...2.3.5

What's Changed

• Remove link to filesystem doc that doesn't exist by @skoontastic in https://github.com/spatie/laravel-multitenancy/pull/349
• Fix migration tests by @masterix21 in https://github.com/spatie/laravel-multitenancy/pull/352
• Improves the SwitchRouteCacheTask by @masterix21 in https://github.com/spatie/laravel-multitenancy/pull/351

New Contributors

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

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

What's Changed

• 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

New Contributors

• @medvinator made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/326
• @MJunaidAhmad made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/329

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

What's Changed

• 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

What's Changed

• Updated link to Tom Schlick's blog by @chimit in https://github.com/spatie/laravel-multitenancy/pull/283
• Fix styling by @b4u7 in https://github.com/spatie/laravel-multitenancy/pull/286
• Describe option that does not default to all tenants... by @telkins in https://github.com/spatie/laravel-multitenancy/pull/288
• [EMPHASYS] Updating language term to improve action by @ricardov03 in https://github.com/spatie/laravel-multitenancy/pull/291
• Handle JobRetryRequested queue event and fix #259 by @aginev in https://github.com/spatie/laravel-multitenancy/pull/298
• 🐛 tenants:artisan backslashes (#296) by @masterix21 in https://github.com/spatie/laravel-multitenancy/pull/300
• Jobs (not?) tenant aware using the config by @masterix21 in https://github.com/spatie/laravel-multitenancy/pull/301

New Contributors

• @chimit made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/283
• @b4u7 made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/286
• @ricardov03 made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/291
• @aginev made their first contribution in https://github.com/spatie/laravel-multitenancy/pull/298

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

• add filterCurrent and rejectCurrent to TenantCollection (#275)

• add Laravel Octane support

• drop support for PHP 7