Download the PHP package fof/redis without Composer
On this page you can find all versions of the php package fof/redis. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
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 redis
Redis sessions, cache, queues & settings
This library allows using Redis as cache, session, settings storage, and for the queue. You can only
enable these services by using a local extender (the extend.php in
the root of your Flarum installation). See the "Set up" section below.
This is an advanced utility for webmasters!
Installation
Install manually with composer:
Set up
In your extend.php:
This enables sessions, cache, settings, and queue to run on redis.
phpredis vs Predis
If the PHP redis extension (ext-redis) is installed, it will be used automatically. Otherwise Predis is used as a fallback. No configuration change is required.
Persistent connections (recommended for phpredis)
With phpredis, connections can be reused across requests within the same PHP-FPM worker process. Add persistent and persistent_id to your config to enable this:
This avoids opening a new TCP connection on every request, which is a significant throughput improvement at scale. persistent_id is a string used to key the connection slot — use the same value across all workers on the same host.
Unix socket
Other phpredis options
| Key | Example | Notes |
|---|---|---|
timeout |
2.0 |
Connect timeout in seconds |
read_timeout |
2.0 |
Per-command timeout |
retry_interval |
100 |
ms between reconnect attempts |
prefix |
'flarum_' |
Key prefix |
compression |
Redis::COMPRESSION_LZ4 |
phpredis ≥ 5.3, requires lz4/zstd compiled into ext-redis |
Multi-instance deployments: This extension can handle distributed cache invalidation across multiple Flarum instances (pods/containers) via Redis Pub/Sub. See DISTRIBUTED_CACHE.md for details.
Settings Cache
This extension includes a settings cache that significantly improves performance by caching all Flarum settings in Redis. This eliminates hundreds to thousands of database queries per page load.
How it works:
- All settings are cached in Redis with a dedicated connection (database 4 by default)
- Settings are loaded from cache on first access, then served from memory
- Cache is invalidated on any settings write, ensuring consistency across multiple instances
- Perfect for multi-container/multi-pod deployments where settings changes must propagate immediately
Configuration:
The settings cache uses database 4 by default. To customize:
To use a completely separate Redis instance for settings:
Performance impact:
- Reduces settings-related database queries by 97-99%
- Typical Flarum page load: 1,500+ settings queries → ~10 queries
- Cache invalidation ensures consistency in multi-instance environments
See "Use different database for each service" below to split up the database for cache vs sessions, queue because a cache clear action will clear sessions and queue jobs as well if they share the same database.
Advanced configuration
-
Disable specific services:
-
Use different database for each service:
-
Completely separate the config array:
- Use a cluster:
Queue
Make sure to start your queue workers, see
the laravel documentation for specifics.
To test the worker can start use php flarum queue:work.
Queue options
The queue allows for several options to be added, retry_after, block_for and after_commit. You can set these
by adding a queue array in the configuration:
You can read up on the meaning of these options in the Laravel Documentation.
Migrating from blomstra/flarum-redis
Simply update the namespace used in your extend.php file from Blomstra\Redis... to FoF\Redis...
Updating
FAQ
Why are there still files in storage/cache? Some code still relies on physical files being present. This includes the formatter cache and the view caches.
