README

Phalcon is an open source web framework delivered as a C extension for the PHP language providing high performance and lower resource consumption.

Bridge PSR-16 connects the Phalcon cache and the PSR-16 (Psr\SimpleCache\CacheInterface) standard in both directions:

• Cache - a PSR-16 cache backed by a Phalcon cache adapter. Use it wherever a Psr\SimpleCache\CacheInterface is expected.
• Adapter - a Phalcon cache adapter that forwards to a PSR-16 cache. Use it to make any PSR-16 cache (e.g. Symfony Cache) act as a Phalcon cache backend.

Installation

You can install the package using composer

composer require phalcon/bridge-psr16

Usage

Cache - use a Phalcon cache through a PSR-16 interface

Phalcon\Bridge\Psr16\Cache is a Psr\SimpleCache\CacheInterface, backed by a Phalcon cache adapter. Hand it to any code that expects a PSR-16 cache.

use Phalcon\Bridge\Psr16\Cache;
use Phalcon\Cache\AdapterFactory;
use Phalcon\Storage\SerializerFactory;

$serializerFactory = new SerializerFactory();
$adapterFactory    = new AdapterFactory($serializerFactory);
$adapter           = $adapterFactory->newInstance('memory');

$cache = new Cache($adapter);

// $cache is a Psr\SimpleCache\CacheInterface
$cache->set('user.42', ['name' => 'Phalcon'], 3600);
$data = $cache->get('user.42');

Adapter - use a PSR-16 cache as a Phalcon cache backend

Phalcon\Bridge\Psr16\Adapter is a Phalcon cache adapter that forwards to a wrapped PSR-16 cache. Use it to back a Phalcon\Cache\Cache with any PSR-16 implementation.

use Phalcon\Bridge\Psr16\Adapter;
use Phalcon\Cache\Cache;
use Phalcon\Storage\SerializerFactory;

// Any Psr\SimpleCache\CacheInterface, e.g. Symfony's Psr16Cache
$psr = new Symfony\Component\Cache\Psr16Cache(/* ... */);

$adapter = new Adapter(new SerializerFactory(), $psr);
$cache   = new Cache($adapter);

// Phalcon cache calls now flow into the PSR-16 cache
$cache->set('key', 'value');

Development

The repository ships a Docker setup for local development and testing. You only need Docker + Docker Compose; the PHP runtime and Phalcon are provided inside the container.

Quick start

docker compose up -d --build
docker compose exec app composer install
docker compose exec app composer test

app is the Compose service name. The running container is bridge-psr16-app (override with PROJECT_PREFIX). It stays up via a sleep infinity keepalive, so you can docker compose exec app <cmd> freely (e.g. composer update).

Choosing the PHP version

The image is built for one PHP version at a time, selected with the PHP_VERSION build arg (default 8.5; supported 8.1–8.5). Because it is a build arg, changing it requires a rebuild (--build):

docker compose up -d --build                  # PHP 8.5 (default)
PHP_VERSION=8.1 docker compose up -d --build  # PHP 8.1
PHP_VERSION=8.4 docker compose up -d --build  # PHP 8.4

The container keeps the same name, so each rebuild replaces the previous one. To run several versions side by side, give each its own Compose project and prefix:

PHP_VERSION=8.1 PROJECT_PREFIX=bridge-psr16-81 docker compose -p bridge-psr16-81 up -d --build
# then: docker exec -w /srv bridge-psr16-81-app composer test

Choosing the backend

The bridge works against either Phalcon runtime, selected with the PHALCON_VARIANT build arg:

docker compose up -d --build                     # package: phalcon/phalcon (v6, default)
PHALCON_VARIANT=ext docker compose up -d --build  # ext: cphalcon C extension (v5)

Tip: drop PHP_VERSION / PHALCON_VARIANT into a .env file in the repo root to avoid prefixing every command — Compose reads it automatically.

Composer scripts

Run them inside the container, e.g. docker compose exec app composer cs:

Links

General

• Official Documentation

Support

• Forum
• Discord
• Stack Overflow

Social Media

• Telegram
• Gab
• LinkedIn
• MeWe
• Facebook
• Twitter