Laravel Permission Laravel Package

What's Changed

Downgraded PHP requirement to 8.3.

• Change PHP requirement from ^8.4 to ^8.3 by @erikn69 in https://github.com/spatie/laravel-permission/pull/2939
• [Docs] Fix grammar: 'offers' -> 'offer' by @tareq-halaby in https://github.com/spatie/laravel-permission/pull/2940

New Contributors

• @tareq-halaby made their first contribution in https://github.com/spatie/laravel-permission/pull/2940

Full Changelog: https://github.com/spatie/laravel-permission/compare/7.2.4...7.3.0

What's Changed

• Internals only.
• Bump ramsey/composer-install from 3 to 4 by @dependabot[bot] in https://github.com/spatie/laravel-permission/pull/2936

Full Changelog: https://github.com/spatie/laravel-permission/compare/7.2.3...7.2.4

What's Changed

• Add Laravel 13 compatibility to old branch, so that 3rd party packages can support L13 without urgent upgrading
• Convert test suite from PHPUnit to Pest by @freekmurze in https://github.com/spatie/laravel-permission/pull/2912

Full Changelog: https://github.com/spatie/laravel-permission/compare/6.24.1...6.25.0

• Update config comments to point to new v7 event class names

What's Changed

• Clear wildcard permission index when assigning or removing roles by @freekmurze in https://github.com/spatie/laravel-permission/pull/2925

Full Changelog: https://github.com/spatie/laravel-permission/compare/7.2.1...7.2.2

What's Changed

• Add Laravel 13 support
• Upgrade to laravel/passport ^13.0
• Drop prefer-lowest from CI matrix

What's Changed

• Fix: do not treat string '0' as empty role/permission input by @laraib15 in https://github.com/spatie/laravel-permission/pull/2916

New Contributors

• @laraib15 made their first contribution in https://github.com/spatie/laravel-permission/pull/2916

Full Changelog: https://github.com/spatie/laravel-permission/compare/7.1.0...7.2.0

Modernize codebase for v7

The aim for v7 is to modernize the codebase while keeping the upgrade path easy. Modern PHP/Laravel features, Pest tests, but no big architectural changes. A future v8 could then tackle larger changes and streamline the package more fundamentally.

Version requirements

• Requires PHP ^8.4 and Laravel ^12.0
• Test suite uses Pest ^3.0

Service provider

• Converted to PackageServiceProvider from spatie/laravel-package-tools
• Removed Lumen support

Class renames

• Event classes now have an Event suffix (PermissionAttached → PermissionAttachedEvent, etc.)
• Command classes now have a Command suffix (CacheReset → CacheResetCommand, etc.)

Type safety

• Added return types and parameter types throughout traits, middleware, exceptions, contracts, and commands

Code modernization

• is_a($this, X::class) → $this instanceof X
• get_class($obj) → $obj::class
• strpos($x, $y) !== false → str_contains($x, $y)
• Constructor promotion in WildcardPermission
• Proper use imports for global classes

Cleanup

• Removed deprecated clearClassPermissions() method
• Removed __construct from Wildcard contract
• Modernized migration stubs

Testing

• Converted entire test suite from PHPUnit to Pest (#2912)

Full Changelog: https://github.com/spatie/laravel-permission/compare/6.24.1...7.0.0

What's Changed

• Add team support to permission:assign-role command by @freekmurze in https://github.com/spatie/laravel-permission/pull/2910

Full Changelog: https://github.com/spatie/laravel-permission/compare/6.24.0...6.24.1

What's Changed

• Add BackedEnum Support to RoleOrPermissionMiddleware by @imhayatunnabi in https://github.com/spatie/laravel-permission/pull/2890
• Add Missing roleOrPermission() route macro by @imhayatunnabi in https://github.com/spatie/laravel-permission/pull/2893
• PHP 8.5: Fix deprecated usage of null as array key by @jnoordsij in https://github.com/spatie/laravel-permission/pull/2904

Internals/Testing

• Skip prefer-lowest dependency version for Laravel 11 by @drbyte in https://github.com/spatie/laravel-permission/pull/2903
• Bump actions/checkout from 5 to 6 by @dependabot[bot] in https://github.com/spatie/laravel-permission/pull/2901

Full Changelog: https://github.com/spatie/laravel-permission/compare/6.23.0...6.24.0

What's Changed

• Performance enhancement: Reduce unnecessary container resolution calls by @imhayatunnabi in https://github.com/spatie/laravel-permission/pull/2889

Full Changelog: https://github.com/spatie/laravel-permission/compare/6.22.0...6.23.0

What's Changed

• Dispatch RoleDetached on syncRoles when events are enabled by @josedaian in https://github.com/spatie/laravel-permission/pull/2869
• Refactor exception handling in migration stub by @alisalehi1380 in https://github.com/spatie/laravel-permission/pull/2886
• Fix TOCTOU race condition in permission loading for concurrent (Octane etc) environments by @imhayatunnabi in https://github.com/spatie/laravel-permission/pull/2883
• Add assign-role command by @sediqzada94 in https://github.com/spatie/laravel-permission/pull/2834
• Test PHP 8.5 by @erikn69 in https://github.com/spatie/laravel-permission/pull/2880
• Bump stefanzweifel/git-auto-commit-action from 6 to 7 by @dependabot[bot] in https://github.com/spatie/laravel-permission/pull/2882
• Update issue template by @AlexVanderbist in https://github.com/spatie/laravel-permission/pull/2875
• Bump actions/checkout from 4 to 5 by @dependabot[bot] in https://github.com/spatie/laravel-permission/pull/2870
• Quick Panel (TALL Flowbite Starter Kit) by @aliqasemzadeh in https://github.com/spatie/laravel-permission/pull/2881

New Contributors

• @josedaian made their first contribution in https://github.com/spatie/laravel-permission/pull/2869
• @alisalehi1380 made their first contribution in https://github.com/spatie/laravel-permission/pull/2886
• @imhayatunnabi made their first contribution in https://github.com/spatie/laravel-permission/pull/2883
• @sediqzada94 made their first contribution in https://github.com/spatie/laravel-permission/pull/2834

Full Changelog: https://github.com/spatie/laravel-permission/compare/6.21.0...6.22.0

What's Changed

• Allow removing multiple roles with the removeRole method by @TobMoeller in https://github.com/spatie/laravel-permission/pull/2859
• [Docs] Correct middleware order for documentation example in teams-permissions.md by @dualklip in https://github.com/spatie/laravel-permission/pull/2863

New Contributors

• @dualklip made their first contribution in https://github.com/spatie/laravel-permission/pull/2863
• @TobMoeller made their first contribution in https://github.com/spatie/laravel-permission/pull/2859

Full Changelog: https://github.com/spatie/laravel-permission/compare/6.20.0...6.21.0

What's Changed

• Add translations support for exception messages by @nAa6666 in https://github.com/spatie/laravel-permission/pull/2852

New Contributors

• @nAa6666 made their first contribution in https://github.com/spatie/laravel-permission/pull/2852

Full Changelog: https://github.com/spatie/laravel-permission/compare/6.19.0...6.20.0

What's Changed

• Revert "Remove collectPermissions that is not being assigned" by @erikn69 in https://github.com/spatie/laravel-permission/pull/2851
• Fix guard_name not used to set default attribute in Role and Permission model by @Ken-vdE in https://github.com/spatie/laravel-permission/pull/2837

Full Changelog: https://github.com/spatie/laravel-permission/compare/6.18.0...6.19.0

What's Changed

• refactor exception throwing in migration file to use throw_if() by @ccaioadriano in https://github.com/spatie/laravel-permission/pull/2819
• Fix: Example in config comment includes permission. prefix on wildcard_permission key by @jerrens in https://github.com/spatie/laravel-permission/pull/2835
• Fix commented config key typo by @erikn69 in https://github.com/spatie/laravel-permission/pull/2844
• Remove collectPermissions that is not being assigned by @JHWelch in https://github.com/spatie/laravel-permission/pull/2840
• [Docs] Update multiple-guards.md by @Ken-vdE in https://github.com/spatie/laravel-permission/pull/2836
• [Docs] Remove extra period by @coreyhn in https://github.com/spatie/laravel-permission/pull/2841
• Add JetAdmin as UI Option. by @aliqasemzadeh in https://github.com/spatie/laravel-permission/pull/2814

New Contributors

• @ccaioadriano made their first contribution in https://github.com/spatie/laravel-permission/pull/2819
• @coreyhn made their first contribution in https://github.com/spatie/laravel-permission/pull/2841
• @jerrens made their first contribution in https://github.com/spatie/laravel-permission/pull/2835
• @Ken-vdE made their first contribution in https://github.com/spatie/laravel-permission/pull/2836
• @JHWelch made their first contribution in https://github.com/spatie/laravel-permission/pull/2840

Full Changelog: https://github.com/spatie/laravel-permission/compare/6.17.0...6.18.0

What's Changed

• Route macro functions: add backed enum support by @Yi-pixel in https://github.com/spatie/laravel-permission/pull/2823

New Contributors

• @Yi-pixel made their first contribution in https://github.com/spatie/laravel-permission/pull/2823

Full Changelog: https://github.com/spatie/laravel-permission/compare/6.16.0...6.17.0

What's Changed

• Middleware: support enums in role/permission middleware by @marklawntalk in https://github.com/spatie/laravel-permission/pull/2813

New Contributors

• @marklawntalk made their first contribution in https://github.com/spatie/laravel-permission/pull/2813

Full Changelog: https://github.com/spatie/laravel-permission/compare/6.15.0...6.16.0

What's Changed

• Added 4 events for adding and removing roles or permissions by @sven-wegner in https://github.com/spatie/laravel-permission/pull/2742
• Fixed bug of loading user roles of different teams to current team by @mohamedds-12 in https://github.com/spatie/laravel-permission/pull/2803

New Contributors

• @sven-wegner made their first contribution in https://github.com/spatie/laravel-permission/pull/2742
• @mohamedds-12 made their first contribution in https://github.com/spatie/laravel-permission/pull/2803

Full Changelog: https://github.com/spatie/laravel-permission/compare/6.14.0...6.15.0

What's Changed

• LDAP model lookup from Auth Provider by @crossplatformconsulting in https://github.com/spatie/laravel-permission/pull/2750

Internals

• Add PHPUnit annotations, for future compatibility with PHPUnit 12 by @drbyte in https://github.com/spatie/laravel-permission/pull/2806

New Contributors

• @crossplatformconsulting made their first contribution in https://github.com/spatie/laravel-permission/pull/2750

Full Changelog: https://github.com/spatie/laravel-permission/compare/6.13.0...6.14.0

What's Changed

• LazyLoading: Explicitly call loadMissing('permissions') when the relation is needed, and test with Model::preventLazyLoading() by @erikn69 in https://github.com/spatie/laravel-permission/pull/2776
• [Docs] Add instructions to reinitialize cache for multi-tenancy key settings when updating multiple tenants in a single request cycle, by @sudkumar in https://github.com/spatie/laravel-permission/pull/2804

New Contributors

• @sudkumar made their first contribution in https://github.com/spatie/laravel-permission/pull/2804

Full Changelog: https://github.com/spatie/laravel-permission/compare/6.12.0...6.13.0

What's Changed

• Support Laravel 12

Full Changelog: https://github.com/spatie/laravel-permission/compare/6.11.0...6.12.0

What's Changed

• Add configurable team resolver for permission team id (helpful for Jetstream, etc) by @adrenallen in https://github.com/spatie/laravel-permission/pull/2790

Internals

• Replace php-cs-fixer with Laravel Pint by @bobbrodie in https://github.com/spatie/laravel-permission/pull/2780

Documentation Updates

• [Docs] Include namespace in example in uuid.md by @ken-tam in https://github.com/spatie/laravel-permission/pull/2764
• [Docs] Include Laravel 11 example in exceptions.md by @frankliniwobi in https://github.com/spatie/laravel-permission/pull/2768
• [Docs] Fix typo in code example in passport.md by @m3skalina in https://github.com/spatie/laravel-permission/pull/2782
• [Docs] Correct username in new-app.md by @trippodi in https://github.com/spatie/laravel-permission/pull/2785
• [Docs] Add composer specificity by @imanghafoori1 in https://github.com/spatie/laravel-permission/pull/2772
• [Docs] Update installation-laravel.md to fix providers.php location. by @curiousteam in https://github.com/spatie/laravel-permission/pull/2796

New Contributors

• @ken-tam made their first contribution in https://github.com/spatie/laravel-permission/pull/2764
• @frankliniwobi made their first contribution in https://github.com/spatie/laravel-permission/pull/2768
• @bobbrodie made their first contribution in https://github.com/spatie/laravel-permission/pull/2780
• @m3skalina made their first contribution in https://github.com/spatie/laravel-permission/pull/2782
• @trippodi made their first contribution in https://github.com/spatie/laravel-permission/pull/2785
• @imanghafoori1 made their first contribution in https://github.com/spatie/laravel-permission/pull/2772
• @curiousteam made their first contribution in https://github.com/spatie/laravel-permission/pull/2796
• @adrenallen made their first contribution in https://github.com/spatie/laravel-permission/pull/2790

Full Changelog: https://github.com/spatie/laravel-permission/compare/6.10.1...6.11.0

What's Changed

• Fix #2749 regression bug in 6.10.0 : "Can no longer delete permissions" by @erikn69 in https://github.com/spatie/laravel-permission/pull/2759

Full Changelog: https://github.com/spatie/laravel-permission/compare/6.10.0...6.10.1

What's Changed

• Fix GuardDoesNotMatch should accept collection by @erikn69 in https://github.com/spatie/laravel-permission/pull/2748
• Improve performance for hydrated collections by @inserve-paul in https://github.com/spatie/laravel-permission/pull/2749
• Only show error if cache key exists and forgetCachedPermissions fails by @erikn69 in https://github.com/spatie/laravel-permission/pull/2707
• Remove v5 cache fallback alias by @drbyte in https://github.com/spatie/laravel-permission/pull/2754

Docs

• [Docs example] Check for 'all' or 'any' permissions before specific permissions by @ceilidhboy in https://github.com/spatie/laravel-permission/pull/2694
• [Docs] Fix typo in uuid.md by @levizoesch in https://github.com/spatie/laravel-permission/pull/2705
• [Docs] Upgrade Guide - Add PR links to upgrade guide by @mraheelkhan in https://github.com/spatie/laravel-permission/pull/2716
• [Docs] use more modern syntax for nullable return type by @galangaidilakbar in https://github.com/spatie/laravel-permission/pull/2719
• [Docs] camelCase variable naming in example by @KamilWojtalak in https://github.com/spatie/laravel-permission/pull/2723
• [Docs] Update using-policies.md by @marcleonhard in https://github.com/spatie/laravel-permission/pull/2741
• [Docs] Example of pushing custom middleware before SubstituteBindings middleware by @WyattCast44 in https://github.com/spatie/laravel-permission/pull/2740

Other

• PHP 8.4 tests by @erikn69 in https://github.com/spatie/laravel-permission/pull/2747
• Include Larastan in dev by @drbyte in https://github.com/spatie/laravel-permission/pull/2755
• Fix comment typo by @machacekmartin in https://github.com/spatie/laravel-permission/pull/2753

New Contributors

• @ceilidhboy made their first contribution in https://github.com/spatie/laravel-permission/pull/2694
• @levizoesch made their first contribution in https://github.com/spatie/laravel-permission/pull/2705
• @galangaidilakbar made their first contribution in https://github.com/spatie/laravel-permission/pull/2719
• @KamilWojtalak made their first contribution in https://github.com/spatie/laravel-permission/pull/2723
• @marcleonhard made their first contribution in https://github.com/spatie/laravel-permission/pull/2741
• @WyattCast44 made their first contribution in https://github.com/spatie/laravel-permission/pull/2740
• @inserve-paul made their first contribution in https://github.com/spatie/laravel-permission/pull/2749
• @machacekmartin made their first contribution in https://github.com/spatie/laravel-permission/pull/2753

Full Changelog: https://github.com/spatie/laravel-permission/compare/6.9.0...6.10.0

What's Changed

• Use ->withPivot() for teamed relationships (allows getPivotColumns()) by @juliangums in https://github.com/spatie/laravel-permission/pull/2679
• Update docblock on $role->hasPermissionTo() to include BackedEnum by @drbyte co-authored by @SanderMuller
• [Docs] Clarify that $guard_name can be an array by @angelej in https://github.com/spatie/laravel-permission/pull/2659
• Fix misc typos in changelog by @szepeviktor in https://github.com/spatie/laravel-permission/pull/2686

New Contributors

• @angelej made their first contribution in https://github.com/spatie/laravel-permission/pull/2659
• @SanderMuller made their first contribution in #2676
• @szepeviktor made their first contribution in https://github.com/spatie/laravel-permission/pull/2686

Full Changelog: https://github.com/spatie/laravel-permission/compare/6.8.0...6.9.0

What's Changed

• Fix can't save the same model twice by @erikn69 in https://github.com/spatie/laravel-permission/pull/2658
• Fix phpstan from #2616 by @erikn69 in https://github.com/spatie/laravel-permission/pull/2685

Full Changelog: https://github.com/spatie/laravel-permission/compare/6.7.0...6.8.0

What's Changed

• Fixed remaining Octane event contract. Update to #2656 in release 6.5.0

Full Changelog: https://github.com/spatie/laravel-permission/compare/6.6.0...6.7.0

What's Changed

• Roles: Support for casting role names to enums by @gajosadrian in https://github.com/spatie/laravel-permission/pull/2616
• Fix permission:show UUID error #2581 by @drbyte in https://github.com/spatie/laravel-permission/pull/2582
• Cover WildcardPermission instance verification based on its own guard (Allow hasAllPermissions and hasAnyPermission to run on custom guard for WildcardPermission) by @AlexandreBellas in https://github.com/spatie/laravel-permission/pull/2608
• Register Laravel "About" details by @drbyte in https://github.com/spatie/laravel-permission/pull/2584

New Contributors

• @gajosadrian made their first contribution in https://github.com/spatie/laravel-permission/pull/2616
• @AlexandreBellas made their first contribution in https://github.com/spatie/laravel-permission/pull/2608

Full Changelog: https://github.com/spatie/laravel-permission/compare/6.5.0...6.6.0

What's Changed

• Octane: Fix wrong event listener by @erikn69 in https://github.com/spatie/laravel-permission/pull/2656
• Teams: Add nullable team_id typehint by @Androlax2 in https://github.com/spatie/laravel-permission/pull/2607
• Blade: simplify the definition of multiple Blade "if" directives by @alissn in https://github.com/spatie/laravel-permission/pull/2628
• DocBlocks: Update HasPermissions::collectPermissions() docblock by @Plytas in https://github.com/spatie/laravel-permission/pull/2641

Internals

• Update role-permissions.md by @killjin in https://github.com/spatie/laravel-permission/pull/2631
• Bump ramsey/composer-install from 2 to 3 by @dependabot in https://github.com/spatie/laravel-permission/pull/2630
• Bump dependabot/fetch-metadata from 1 to 2 by @dependabot in https://github.com/spatie/laravel-permission/pull/2642

New Contributors

• @alissn made their first contribution in https://github.com/spatie/laravel-permission/pull/2628
• @Androlax2 made their first contribution in https://github.com/spatie/laravel-permission/pull/2607
• @Plytas made their first contribution in https://github.com/spatie/laravel-permission/pull/2641
• @killjin made their first contribution in https://github.com/spatie/laravel-permission/pull/2631

Full Changelog: https://github.com/spatie/laravel-permission/compare/6.4.0...6.5.0

• Laravel 11 Support

What's Changed

• Add Laravel 11 to workflow run tests by @mraheelkhan in https://github.com/spatie/laravel-permission/pull/2605
• And Passport 12

Internals

• Update to use Larastan Org by @arnebr in https://github.com/spatie/laravel-permission/pull/2585
• laravel-pint-action to major version tag by @erikn69 in https://github.com/spatie/laravel-permission/pull/2586

New Contributors

• @arnebr made their first contribution in https://github.com/spatie/laravel-permission/pull/2585
• @mraheelkhan made their first contribution in https://github.com/spatie/laravel-permission/pull/2605

Full Changelog: https://github.com/spatie/laravel-permission/compare/6.3.0...6.4.0

What's Changed

• Octane Fix: Clear wildcard permissions on Tick in https://github.com/spatie/laravel-permission/pull/2583

Full Changelog: https://github.com/spatie/laravel-permission/compare/6.2.0...6.3.0

What's Changed

• Skip duplicates on sync (was triggering Integrity Constraint Violation error) by @erikn69 in https://github.com/spatie/laravel-permission/pull/2574

Full Changelog: https://github.com/spatie/laravel-permission/compare/6.1.0...6.2.0