.gitattributes

@@ -13,6 +13,8 @@
 /tests              export-ignore
 /.editorconfig      export-ignore
 /.php_cs.dist.php   export-ignore
+/phpstan*           export-ignore
 /.styleci.yml       export-ignore
 /CHANGELOG.md       export-ignore
 /CONTRIBUTING.md    export-ignore
+

.github/workflows/dependabot-auto-merge.yml

@@ -13,7 +13,7 @@ jobs:
 
       - name: Dependabot metadata
         id: metadata
-        uses: dependabot/fetch-metadata@v1.3.6
+        uses: dependabot/fetch-metadata@v1.6.0
         with:
           github-token: "${{ secrets.GITHUB_TOKEN }}"
           compat-lookup: true

.github/workflows/fix-php-code-style-issues.yml

@@ -11,14 +11,14 @@ jobs:
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           ref: ${{ github.head_ref }}
 
       - name: Fix PHP code style issues
-        uses: aglipanci/laravel-pint-action@2.1.0
+        uses: aglipanci/laravel-pint-action@2.3.0
 
       - name: Commit changes
-        uses: stefanzweifel/git-auto-commit-action@v4
+        uses: stefanzweifel/git-auto-commit-action@v5
         with:
           commit_message: Fix styling

.github/workflows/phpstan.yml

@@ -0,0 +1,31 @@
+name: PHPStan
+
+on:
+    push:
+        paths:
+            - '**.php'
+            - 'phpstan.neon.dist'
+
+jobs:
+    phpstan:
+        name: phpstan
+        runs-on: ubuntu-latest
+        steps:
+            - uses: actions/checkout@v4
+
+            - name: Setup PHP
+              uses: shivammathur/setup-php@v2
+              with:
+                  php-version: 8.1
+                  coverage: none
+
+            - name: Install composer dependencies
+              uses: ramsey/composer-install@v2
+
+            - name: Install larastan
+              run: |
+                  composer require "nunomaduro/larastan" --no-interaction --no-update
+                  composer update --prefer-dist --no-interaction
+
+            - name: Run PHPStan
+              run: ./vendor/bin/phpstan --error-format=github

.github/workflows/run-tests-L8.yml → .github/workflows/run-tests.yml

@@ -9,33 +9,27 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        php: [8.2, 8.1, 8.0, 7.4, 7.3]
-        laravel: [10.*, 9.*, 8.*]
+        php: [8.3, 8.2, 8.1, 8.0]
+        laravel: ["^10.0", "^9.0", "^8.12"]
         dependency-version: [prefer-lowest, prefer-stable]
         include:
-          - laravel: 10.*
+          - laravel: "^10.0"
             testbench: 8.*
-          - laravel: 9.*
+          - laravel: "^9.0"
             testbench: 7.*
-          - laravel: 8.*
-            testbench: 6.23
+          - laravel: "^8.12"
+            testbench: "^6.23"
         exclude:
-            - laravel: 10.*
+            - laravel: "^10.0"
               php: 8.0
-            - laravel: 10.*
-              php: 7.4
-            - laravel: 10.*
-              php: 7.3
-            - laravel: 9.*
-              php: 7.4
-            - laravel: 9.*
-              php: 7.3
+            - laravel: "^8.12"
+              php: 8.3
 
     name: P${{ matrix.php }} - L${{ matrix.laravel }} - ${{ matrix.dependency-version }}
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
       - name: Setup PHP
         uses: shivammathur/setup-php@v2
@@ -44,6 +38,10 @@ jobs:
           extensions: curl, mbstring, zip, pcntl, pdo, sqlite, pdo_sqlite, iconv
           coverage: none
 
+      - name: Install dependencies (remove passport)
+        run: composer remove --dev laravel/passport --no-interaction --no-update
+        if: matrix.laravel == '^8.12'
+
       - name: Install dependencies
         run: |
           composer require "laravel/framework:${{ matrix.laravel }}" "orchestra/testbench:${{ matrix.testbench }}" "symfony/console:>=4.3.4" "mockery/mockery:^1.3.2" "nesbot/carbon:>=2.62.1" --no-interaction --no-update

.github/workflows/test-cache-drivers.yml

@@ -0,0 +1,67 @@
+name: "Run Tests - Cache Drivers"
+
+on: [push, pull_request]
+
+jobs:
+  cache:
+
+    runs-on: ubuntu-latest
+
+    services:
+      redis:
+        image: redis
+        ports:
+          - 6379/tcp
+        options: --health-cmd="redis-cli ping" --health-interval=10s --health-timeout=5s --health-retries=3
+
+    strategy:
+      fail-fast: false
+
+    name: Cache Drivers
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: 8.2
+          extensions: curl, mbstring, zip, pcntl, pdo, sqlite, pdo_sqlite, iconv, memcache
+          coverage: none
+
+      - name: Install dependencies
+        run: |
+          composer require "predis/predis" --no-interaction --no-update
+          composer update --prefer-stable --prefer-dist --no-interaction
+
+      - name: Execute tests - memcached cache driver
+        run: |
+          vendor/bin/phpunit
+        env:
+          CACHE_DRIVER: memcached
+
+      - name: Execute tests - redis cache driver
+        run: |
+          vendor/bin/phpunit
+        env:
+          CACHE_DRIVER: redis
+          REDIS_PORT: ${{ job.services.redis.ports['6379'] }}
+
+      - name: Execute tests - database cache driver
+        run: |
+          vendor/bin/phpunit
+        env:
+          CACHE_DRIVER: database
+
+      - name: Execute tests - file cache driver
+        run: |
+          vendor/bin/phpunit
+        env:
+          CACHE_DRIVER: file
+
+      - name: Execute tests - array cache driver
+        run: |
+          vendor/bin/phpunit
+        env:
+          CACHE_DRIVER: array

.github/workflows/update-changelog.yml

@@ -10,7 +10,7 @@ jobs:
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           ref: main
 
@@ -21,7 +21,7 @@ jobs:
           release-notes: ${{ github.event.release.body }}
 
       - name: Commit updated CHANGELOG
-        uses: stefanzweifel/git-auto-commit-action@v4.16.0
+        uses: stefanzweifel/git-auto-commit-action@v5
         with:
           branch: main
           commit_message: Update CHANGELOG

CHANGELOG.md

@@ -2,6 +2,42 @@
 
 All notable changes to `laravel-permission` will be documented in this file
 
+## 5.11.1 - 2023-10-25
+
+No functional changes. Just several small updates to the Documentation.
+
+**Full Changelog**: https://github.com/spatie/laravel-permission/compare/5.11.0...5.11.1
+
+## 5.11.0 - 2023-08-30
+
+### What's Changed
+
+- [V5] Avoid triggering `eloquent.retrieved` event by @erikn69 in https://github.com/spatie/laravel-permission/pull/2490
+
+**Full Changelog**: https://github.com/spatie/laravel-permission/compare/5.10.2...5.11.0
+
+## 5.10.2 - 2023-07-04
+
+### What's Changed
+
+- Fix Eloquent Strictness on `permission:show` Command by @erikn69 in https://github.com/spatie/laravel-permission/pull/2457
+
+**Full Changelog**: https://github.com/spatie/laravel-permission/compare/5.10.1...5.10.2
+
+## 5.10.1 - 2023-04-12
+
+### What's Changed
+
+- [V5] Fix artisan command `permission:show` output of roles with underscores by @erikn69 in https://github.com/spatie/laravel-permission/pull/2396
+
+**Full Changelog**: https://github.com/spatie/laravel-permission/compare/5.10.0...5.10.1
+
+## 5.10.0 - 2023-03-22
+
+### What's Changed
+
+- Fix delete permissions on Permissions Model by @erikn69 in https://github.com/spatie/laravel-permission/pull/2366
+
 ## 5.9.1 - 2023-02-06
 
 Apologies for the break caused by 5.9.0 !
@@ -593,6 +629,11 @@ The following changes are not "breaking", but worth making the updates to your a
 
 
 
+
+
+
+
+
 ```
 1. Also this is a good time to point out that now with v2.25.0 and v2.26.0 most permission-cache-reset scenarios may no longer be needed in your app, so it's worth reviewing those cases, as you may gain some app speed improvement by removing unnecessary cache resets.
 
@@ -646,6 +687,11 @@ The following changes are not "breaking", but worth making the updates to your a
 
 
 
+
+
+
+
+
 ```
 ## 2.19.1 - 2018-09-14
 

README.md

@@ -49,20 +49,20 @@ We invest a lot of resources into creating [best in class open source packages](
 
 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).
 
-### Testing
-
-``` bash
-composer test
-```
-
-### Changelog
+## Changelog
 
 Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.
 
 ## Contributing
 
 Please see [CONTRIBUTING](https://github.com/spatie/.github/blob/main/CONTRIBUTING.md) for details.
 
+### Testing
+
+``` bash
+composer test
+```
+
 ### Security
 
 If you discover any security-related issues, please email [security@spatie.be](mailto:security@spatie.be) instead of using the issue tracker.
@@ -92,8 +92,8 @@ And a special thanks to [Caneco](https://twitter.com/caneco) for the logo ✨
 ## Alternatives
 
 - [Povilas Korop](https://twitter.com/@povilaskorop) did an excellent job listing the alternatives [in an article on Laravel News](https://laravel-news.com/two-best-roles-permissions-packages). In that same article, he compares laravel-permission to [Joseph Silber](https://github.com/JosephSilber)'s [Bouncer]((https://github.com/JosephSilber/bouncer)), which in our book is also an excellent package.
-- [ultraware/roles](https://github.com/ultraware/roles) takes a slightly different approach to its features.
 - [santigarcor/laratrust](https://github.com/santigarcor/laratrust) implements team support
+- [ultraware/roles](https://github.com/ultraware/roles) (archived) takes a slightly different approach to its features.
 - [zizaco/entrust](https://github.com/zizaco/entrust) offers some wildcard pattern matching
 
 ## License