nuewire / cache
A safe Laravel cache management page and command for the Nuewire platform.
Requires
- php: ^8.2
- illuminate/auth: ^11.0|^12.0|^13.0
- illuminate/cache: ^11.0|^12.0|^13.0
- illuminate/console: ^11.0|^12.0|^13.0
- illuminate/contracts: ^11.0|^12.0|^13.0
- illuminate/filesystem: ^11.0|^12.0|^13.0
- illuminate/http: ^11.0|^12.0|^13.0
- illuminate/support: ^11.0|^12.0|^13.0
- illuminate/translation: ^11.0|^12.0|^13.0
- illuminate/view: ^11.0|^12.0|^13.0
- livewire/livewire: ^3.6|^4.0.3
- nuewire/support: ^1.0
Requires (Dev)
- orchestra/testbench: ^9.0|^10.0|^11.0
- phpunit/phpunit: ^11.0|^12.0
Suggests
- nuewire/acl: Adds granular authorization for viewing and clearing caches.
- nuewire/logs: Records optional audit trails for cache-clearing actions.
- nuewire/platform: Adds Clear Cache under Plugin > Tools in the Nuewire admin navigation.
- spatie/laravel-permission: Enables permission-cache detection and clearing.
README
Granular Laravel cache management for the Nuewire platform.
Install
composer require nuewire/cache php artisan nuewire:cache:install php artisan optimize:clear
With nuewire/platform 2, the page is registered under Plugin → Tools → Clear Cache at /admin/plugin/clear-cache. Mount the page directly when Platform is not installed:
<livewire:nuewire-cache />
Supported targets
application: flush the configured Laravel cache store.config: runconfig:clear.route: runroute:clear.view: runview:clear.event: runevent:clear.permission: call Spatie PermissionRegistrar when available.
Application cache is intentionally not selected by default. Flushing a shared cache store can remove sessions, rate limits, password-reset tokens, queue overflow payloads, or application data.
CLI
php artisan nuewire:cache:clear
php artisan nuewire:cache:clear config route view event
php artisan nuewire:cache:clear permission
php artisan nuewire:cache:clear --all
php artisan nuewire:cache:clear --all --force # required in production by default
Configuration
The published file is config/nuewire/cache.php. Set a dedicated application cache store when necessary:
NUEWIRE_CACHE_APPLICATION_STORE=redis
The package never accepts arbitrary Artisan command names. Targets are mapped through a fixed enum allowlist and cache clearing is guarded by a process lock.
Permissions
cache.viewcache.clear
When Nuewire Logs is installed, the package records cache.cleared, cache.partially-cleared, or cache.failed audit events.