PHPackages                             nations-original/php-sf-cache - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Caching](/categories/caching)
4. /
5. nations-original/php-sf-cache

ActiveLibrary[Caching](/categories/caching)

nations-original/php-sf-cache
=============================

PSR-16 cache adapters (Redis, Memcached, APCu) with helper functions. Works with Symfony, custom frameworks, and legacy projects.

v2.0.1(1mo ago)239↓50%2ISCPHPPHP >=8.2

Since May 6Pushed 1mo agoCompare

[ Source](https://github.com/Ondottr/cache)[ Packagist](https://packagist.org/packages/nations-original/php-sf-cache)[ Docs](https://github.com/Ondottr/cache)[ RSS](/packages/nations-original-php-sf-cache/feed)WikiDiscussions master Synced 1w ago

READMEChangelog (4)Dependencies (6)Versions (5)Used By (2)

php-sf-cache
============

[](#php-sf-cache)

PSR-16 cache adapters for Redis, Memcached, APCu, and the filesystem. Works standalone, with Symfony, with legacy projects, and with any PSR-16-aware framework.

Installation
------------

[](#installation)

Via Packagist:

```
composer require nations-original/php-sf-cache
```

Adapters
--------

[](#adapters)

AdapterHelperClassRequirementLimitationsRedis`rca()``RedisCacheAdapter``predis/predis`, running Redis—APCu`aca()``APCuCacheAdapter``ext-apcu`—Memcached`mca()``MemcachedCacheAdapter``ext-memcached`, running Memcached`deleteByKeyPattern()` throws `UnsupportedPlatformException` — Memcached has no key-enumeration protocolFileSystem`fca()``FileSystemCacheAdapter``symfony/filesystem` (included)—Auto`ca()`—Picks APCu if available, else RedisInherits the limitations of the selected adapterAll adapters implement `PHP_SF\Cache\CacheInterface` which extends `Psr\SimpleCache\CacheInterface` (PSR-16).

---

Setup by environment
--------------------

[](#setup-by-environment)

### Symfony

[](#symfony)

**1. Wire the connections in `services.yaml`:**

```
PHP_SF\Cache\Connection\Redis:
  arguments:
    - '%env(REDIS_CACHE_URL)%'
    - '%env(SERVER_PREFIX)%:%env(APP_ENV)%:'

PHP_SF\Cache\Adapter\RedisCacheAdapter:
  arguments:
    - '@PHP_SF\Cache\Connection\Redis'

PHP_SF\Cache\Connection\Memcached:
  arguments:
    - '%env(MEMCACHED_SERVER)%'
    - '%env(int:MEMCACHED_PORT)%'
    - '%env(SERVER_PREFIX)%:%env(APP_ENV)%:'

PHP_SF\Cache\Adapter\MemcachedCacheAdapter:
  arguments:
    - '@PHP_SF\Cache\Connection\Memcached'

PHP_SF\Cache\Adapter\FileSystemCacheAdapter:
  arguments:
    $filesystem: '@filesystem'
    $cacheDir:   '%kernel.cache_dir%/php_sf_cache'
```

Injecting the connection into the adapter gives the container a proper dependency edge: it guarantees the connection is instantiated (and therefore configured) before the adapter is first used.

**2. Use via PSR-16 (type-hint `Psr\SimpleCache\CacheInterface`):**

```
use Psr\SimpleCache\CacheInterface;

class MyService
{
    public function __construct(private CacheInterface $cache) {}
}
```

Bind in `services.yaml`:

```
Psr\SimpleCache\CacheInterface: '@PHP_SF\Cache\Adapter\RedisCacheAdapter'
```

**3. Or wrap as PSR-6 (for Symfony cache pools):**

```
use Symfony\Component\Cache\Psr16Cache;
use PHP_SF\Cache\Adapter\RedisCacheAdapter;

$pool = new Psr16Cache(RedisCacheAdapter::getInstance());
```

---

### Laravel

[](#laravel)

The service provider is auto-discovered via `composer.json`. No manual registration needed.

It reads connection details from Laravel's existing config so you don't need extra env vars:

AdapterLaravel config sourceRedis`config/database.php` → `redis.cache` (fallback: `redis.default`)Memcached`config/cache.php` → `stores.memcached.servers[0]`FileSystem`storage/framework/cache/php_sf_cache`The key prefix is built as `{APP_NAME}:{APP_ENV}:` automatically.

By default `PHP_SF\Cache\CacheInterface` is bound to the auto adapter (`ca()`: APCu if available, else Redis). Override in `AppServiceProvider` if you need a specific one:

```
use PHP_SF\Cache\CacheInterface;
use PHP_SF\Cache\Adapter\RedisCacheAdapter;

public function register(): void
{
    $this->app->singleton(CacheInterface::class, fn() => rca());
}
```

Or type-hint `PHP_SF\Cache\CacheInterface` directly in your classes and let the container inject it.

---

### Custom framework (PHP-SF or similar)

[](#custom-framework-php-sf-or-similar)

Set env vars before the first cache call (e.g. in your bootstrap or `.env`):

```
REDIS_CACHE_URL=redis://localhost:6379/0
SERVER_PREFIX=myapp
APP_ENV=prod

MEMCACHED_SERVER=localhost
MEMCACHED_PORT=11211

CACHE_DIR=/var/www/myapp/var/cache/php_sf_cache

```

Then call helpers anywhere:

```
rca()->set('user:42', $userData, 3600);
$user = rca()->get('user:42');

fca()->set('report', $heavyObject);   // filesystem, survives process restarts
ca()->set('flag', true);              // auto: APCu if available, else Redis
```

Or configure explicitly in bootstrap:

```
use PHP_SF\Cache\Connection\Redis;
use PHP_SF\Cache\Adapter\FileSystemCacheAdapter;
use Symfony\Component\Filesystem\Filesystem;

Redis::configure('redis://localhost:6379/0', 'myapp:prod:');
FileSystemCacheAdapter::configure(new Filesystem(), '/var/cache/myapp');
```

---

### Legacy projects (no framework)

[](#legacy-projects-no-framework)

Composer autoload takes care of the function stubs. Just set `$_ENV` or call `configure()`:

```
require 'vendor/autoload.php';

$_ENV['REDIS_CACHE_URL'] = 'redis://127.0.0.1:6379/0';

rca()->set('greeting', 'hello', 60);
echo rca()->get('greeting'); // hello
```

---

### Custom implementation

[](#custom-implementation)

Extend `AbstractCacheAdapter` and implement `CacheInterface`:

```
use PHP_SF\Cache\Abstracts\AbstractCacheAdapter;

final class MyCustomAdapter extends AbstractCacheAdapter
{
    public function get(string $key, mixed $default = null): mixed { /* ... */ }
    public function set(string $key, mixed $value, $ttl = null): bool { /* ... */ }
    public function delete(string $key): bool { /* ... */ }
    public function clear(): bool { /* ... */ }
    public function has(string $key): bool { /* ... */ }
    public function deleteByKeyPattern(string $keyPattern): bool { /* ... */ }
}
```

Or implement `PHP_SF\Cache\CacheInterface` directly without the abstract base.

---

API reference
-------------

[](#api-reference)

### All adapters (PSR-16 + pattern deletion)

[](#all-adapters-psr-16--pattern-deletion)

```
$cache->get(string $key, mixed $default = null): mixed
$cache->set(string $key, mixed $value, int|DateInterval|null $ttl = 86400): bool  // null = no expiry
$cache->delete(string $key): bool
$cache->clear(): bool
$cache->has(string $key): bool
$cache->getMultiple(iterable $keys, mixed $default = null): iterable
$cache->setMultiple(iterable $values, int|DateInterval|null $ttl = 86400): bool   // null = no expiry
$cache->deleteMultiple(iterable $keys): bool

// Pattern wildcards: prefix*, *suffix, *contains*, *
// Returns true when no keys match (nothing to delete = success)
$cache->deleteByKeyPattern(string $keyPattern): bool
```

### Redis extras

[](#redis-extras)

```
rca()->pub(string $channel, mixed $message): bool  // pub/sub publish

rc()  // raw Predis\Client
rp()  // Predis\Pipeline
```

### Adapter-specific notes

[](#adapter-specific-notes)

**Redis** — all values are stored as strings by Predis. Integers, floats, and booleans round-trip as strings. Cast explicitly on retrieval:

```
$count   = (int)   rca()->get('hits');
$ratio   = (float) rca()->get('ratio');
$enabled = (bool)  rca()->get('feature:enabled');   // '' = false, '1' = true
```

**FileSystem** — accepts scalar, array, and object values (anything PHP can serialize). `deleteByKeyPattern()` reads all cache files to match original keys — fine for moderate cache sizes, not recommended for millions of entries. Survives process restarts; ideal for heavy computed objects.

**Memcached** — `deleteByKeyPattern()` is not supported and always throws `UnsupportedPlatformException`. The Memcached protocol provides no way to enumerate keys, so pattern-based deletion cannot be implemented. Use Redis or FileSystem if you need this feature.

---

Connection configuration reference
----------------------------------

[](#connection-configuration-reference)

### Redis

[](#redis)

MethodDescription`Redis::configure(string $url, string $prefix = '')`Explicit config. Call before first use.`$_ENV['REDIS_CACHE_URL']`e.g. `redis://localhost:6379/0``$_ENV['SERVER_PREFIX']` + `$_ENV['APP_ENV']`Builds key prefix `{prefix}:{env}:`### Memcached

[](#memcached)

MethodDescription`Memcached::configure(string $server, int $port, string $prefix = '')`Explicit config.`$_ENV['MEMCACHED_SERVER']`e.g. `localhost``$_ENV['MEMCACHED_PORT']`e.g. `11211``$_ENV['SERVER_PREFIX']` + `$_ENV['APP_ENV']`Builds key prefix### FileSystemCacheAdapter

[](#filesystemcacheadapter)

MethodDescription`FileSystemCacheAdapter::configure(Filesystem $fs, string $cacheDir)`Explicit config.`$_ENV['CACHE_DIR']`Directory path*(default)*`sys_get_temp_dir()/php_sf_cache`---

License
-------

[](#license)

ISC — see [LICENSE](LICENSE).

###  Health Score

44

—

FairBetter than 90% of packages

Maintenance93

Actively maintained with recent releases

Popularity14

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

4

Last Release

33d ago

Major Versions

v1.0.1 → v2.0.02026-05-06

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/33568483?v=4)[Dmytro Dyvulskyi](/maintainers/Ondottr)[@Ondottr](https://github.com/Ondottr)

---

Top Contributors

[![Ondottr](https://avatars.githubusercontent.com/u/33568483?v=4)](https://github.com/Ondottr "Ondottr (4 commits)")

###  Code Quality

TestsPHPUnit

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/nations-original-php-sf-cache/health.svg)

```
[![Health](https://phpackages.com/badges/nations-original-php-sf-cache/health.svg)](https://phpackages.com/packages/nations-original-php-sf-cache)
```

###  Alternatives

[aws/aws-sdk-php

AWS SDK for PHP - Use Amazon Web Services in your PHP project

6.3k532.1M2.5k](/packages/aws-aws-sdk-php)[easycorp/easyadmin-bundle

Admin generator for Symfony applications

4.3k17.5M370](/packages/easycorp-easyadmin-bundle)[oro/platform

Business Application Platform (BAP)

641140.7k103](/packages/oro-platform)[civicrm/civicrm-core

Open source constituent relationship management for non-profits, NGOs and advocacy organizations.

744284.3k34](/packages/civicrm-civicrm-core)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

585.4M506](/packages/shopware-core)[tempest/framework

The PHP framework that gets out of your way.

2.2k31.1k11](/packages/tempest-framework)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)