Download the PHP package erjon/laravel-cache-groups without Composer
On this page you can find all versions of the php package erjon/laravel-cache-groups. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download erjon/laravel-cache-groups
More information about erjon/laravel-cache-groups
Files in erjon/laravel-cache-groups
Package laravel-cache-groups
Short Description Laravel cache groups for older versions and for drivers that don't support cache tags
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package laravel-cache-groups
Laravel Cache Groups
A Laravel package that adds cache()->groups() functionality to cache drivers that don't support cache()->tags(). This package provides a drop-in replacement for cache tags, making it work with all cache drivers including File, Database, and others that lack native tagging support.
Features
- Universal Support: Works with all Laravel cache drivers (File, Database, Redis, Memcached, etc.)
- Drop-in Replacement: Identical API to
cache()->tags()- just replacetags()withgroups() - Native Fallback: Automatically uses native
tags()when available for optimal performance - Laravel 7+: Supports Laravel 7.x through 11.x
Why Cache Groups?
Laravel's cache()->tags() is powerful but only works with Redis, Memcached, and Array cache drivers. If you're using File or Database drivers, calling tags() throws a BadMethodCallException.
Cache Groups solves this by:
- Tracking cache keys explicitly for each group
- Enabling selective cache invalidation (flush by group)
- Providing the same API experience across all cache drivers
- Automatically falling back to native tags when supported
Comparison: Cache Tags vs Cache Groups
| Feature | cache()->tags() |
cache()->groups() |
|---|---|---|
| File Driver Support | ❌ No | ✅ Yes |
| Database Driver Support | ❌ No | ✅ Yes |
| Redis Support | ✅ Yes | ✅ Yes (delegates to tags) |
| Memcached Support | ✅ Yes | ✅ Yes (delegates to tags) |
| Array Driver Support | ✅ Yes | ✅ Yes (delegates to tags) |
| API Compatibility | Standard | 100% Compatible |
| Performance on Redis | Optimal | Optimal (uses native tags) |
| Performance on File | N/A | Good (explicit tracking) |
| Laravel Version | 5.8+ | 7.0+ |
| Migration Effort | N/A | Replace tags() with groups() |
Installation
Install the package via Composer:
The package will automatically register itself via Laravel's package auto-discovery.
Manual Registration (Laravel 5.x - 6.x)
If using older Laravel versions without auto-discovery, add the service provider to config/app.php:
Usage
Basic Usage
The API is identical to Laravel's cache()->tags():
Available Methods
All standard Laravel cache methods are supported:
Variadic Group Syntax
You can also pass groups as separate arguments:
How It Works
For Drivers Without Tag Support (File, Database)
Cache Groups tracks all keys belonging to each group:
-
When you store a value:
Cache::groups(['products'])->put('item:1', $data, 3600)- The key
item:1is added to theproductsgroup's key list - This list is stored in the cache at
group:products:keys
- The key
-
When you flush a group:
Cache::groups(['products'])->flush()- All keys in the group's list are deleted
- The group's key list itself is cleared
- When you forget a key:
Cache::groups(['products'])->forget('item:1')- The key is removed from the cache
- The key is removed from all group membership lists (prevents memory leaks)
For Drivers With Tag Support (Redis, Memcached, Array)
The package automatically detects if the cache driver supports tags and delegates to the native tags() implementation for better performance:
This ensures you get the best possible performance while maintaining API consistency.
Migration from Tags to Groups
If you're currently using cache()->tags() with Redis/Memcached and want to support File/Database drivers, simply replace tags() with groups():
Before:
After:
That's it! Your code now works with all cache drivers.
Performance Considerations
Key Tracking Overhead
When using drivers without native tag support (File, Database), the package tracks keys explicitly:
- Storage: Each group maintains a list of its member keys in the cache
- Write Operations: Each
put(),forever(),add()adds to the group's key list - Flush Operations: Iterates through all tracked keys to delete them
- Memory: Large groups (10,000+ keys) may impact memory usage
Best Practices
-
Use Native Tags When Possible: If you're on Redis/Memcached, consider using
cache()->tags()directly for maximum performance -
Limit Group Size: Try to keep groups under 10,000 keys for optimal performance
-
Group Strategically: Organize your cache into logical groups that are flushed together
- Clean Up Manually: While the package removes keys from groups when using
forget(), expired keys will remain in group lists until the group is flushed. Consider periodic group flushes for long-lived groups with high churn.
Testing
Run the test suite:
Requirements
- PHP 7.2 or higher
- Laravel 7.x, 8.x, 9.x, 10.x, or 11.x
License
The MIT License (MIT). Please see License File for more information.
Changelog
1.0.0 - Initial Release
- Initial release with full cache groups support
- Support for Laravel 7+ and all cache drivers
- Automatic fallback to native tags when available
- Comprehensive test suite
