PHPackages                             sympress/framework-bundle - 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. sympress/framework-bundle

ActiveLibrary[Caching](/categories/caching)

sympress/framework-bundle
=========================

SymPress FrameworkBundle bridge with Symfony Cache integration and WordPress object-cache support.

1.0.1(1mo ago)001GPL-2.0-or-laterPHPPHP ^8.5CI passing

Since Jun 14Pushed 2w agoCompare

[ Source](https://github.com/SymPress/framework-bundle)[ Packagist](https://packagist.org/packages/sympress/framework-bundle)[ RSS](/packages/sympress-framework-bundle/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (2)Dependencies (18)Versions (3)Used By (1)

SymPress Framework Bundle
=========================

[](#sympress-framework-bundle)

[![Checks](https://camo.githubusercontent.com/2a73f640b5816dc54c3950dbb21910b27ae757f542c94c3e4b0abf88d7df1ea8/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f53796d50726573732f6672616d65776f726b2d62756e646c652f71612e796d6c3f6272616e63683d6d61696e266c6162656c3d636865636b73)](https://github.com/SymPress/framework-bundle/actions/workflows/qa.yml) [![Release](https://camo.githubusercontent.com/bd873d663081e59c56f06445cf0d481c37b22632aa114e6832579ed2eebb09fc/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f53796d50726573732f6672616d65776f726b2d62756e646c653f6c6162656c3d72656c65617365)](https://github.com/SymPress/framework-bundle/releases) [![PHP](https://camo.githubusercontent.com/17dc52379b75f4d5a6d879d73c2d7f956749ccf23ea2423a2e2ac5f644c709ef/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646570656e64656e63792d762f73796d70726573732f6672616d65776f726b2d62756e646c652f7068702e7376673f6c6162656c3d706870)](https://packagist.org/packages/sympress/framework-bundle) [![Downloads](https://camo.githubusercontent.com/58b4e96fca7807d8f1da3ba802a89c9a559f42080b420421f149695dfe000750/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f73796d70726573732f6672616d65776f726b2d62756e646c652e7376673f6c6162656c3d646f776e6c6f616473)](https://packagist.org/packages/sympress/framework-bundle/stats) [![License: GPL-2.0-or-later](https://camo.githubusercontent.com/26f8b6541ea045cc1dbc2267208158b5a7ebbf5cf437c4b486d80fee9386f77e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d47504c2d2d322e302d2d6f722d2d6c617465722d626c75652e737667)](LICENSE) [![Security Policy](https://camo.githubusercontent.com/7a0ecd25391c2821401e28d753557f53c5fe267b349b8b4032bb4ca1ef462ee7/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f73656375726974792d706f6c6963792d3265613434662e737667)](SECURITY.md)

`sympress/framework-bundle` is a SymPress bundle that brings Symfony-style framework services into WordPress projects. It now uses Symfony's real `symfony/framework-bundle` as the compatibility layer and keeps the SymPress WordPress object-cache integration on top.

The core surfaces are:

- Symfony FrameworkBundle web/kernel services such as request stack, HTTP kernel, controllers, error rendering, routing infrastructure and console integration.
- Symfony Cache 8.2 based PSR-6, PSR-16 and Symfony Contracts cache services.
- Framework-Bundle-style cache pool services such as `cache.app`, `cache.system`, `cache.validator`, `cache.serializer`, adapter prototypes, clearers, pruners, tag-aware pools, Redis tag-aware pools, named custom pools and `cache:pool:*` console commands.
- WordPress `object-cache.php` drop-in support with a Symfony-oriented operational surface: APCu, Redis, Memcached, filesystem, SQLite/PDO, request-memory caching, multisite global groups, non-persistent groups, group flushing, runtime flushing, admin-bar flush, WP-CLI flush/purge and scheduled purge.

Optional FrameworkBundle integrations such as Form, Validator, Serializer, Messenger, Mailer, Notifier, HttpClient, Workflow, Lock, RateLimiter, UID, WebLink and Webhook are enabled through Symfony's upstream configuration whenever the matching Symfony component is installed.

Install
-------

[](#install)

Require the package in a SymPress project:

```
composer require sympress/framework-bundle
```

Production projects must provide a strong `APP_SECRET`. The bundle passes `APP_SECRET` directly to Symfony's FrameworkBundle and does not fall back to predictable project paths.

The bundle is discovered through Composer metadata:

```
{
  "extra": {
    "kernel": {
      "bundle": "SymPress\\Framework\\SymPressFrameworkBundle",
            "entry": "framework-bundle"
        }
    }
}
```

Local Development
-----------------

[](#local-development)

Run the package checks before opening a pull request:

```
composer qa
```

The QA script runs PHPCS, PHPStan and PHPUnit. The GitHub workflow uses the shared SymPress workflow set and the organization `.github` repository provides issue and community templates.

The separate cache-backend smoke runs the native adapters against real Redis and Memcached services in CI. Run it locally with both PHP extensions and services available:

```
SYMPRESS_LIVE_CACHE_TESTS=1 composer tests:backends
```

Cache Pool Configuration
------------------------

[](#cache-pool-configuration)

The bundle provides defaults that work without project config. Projects can override the `framework.cache` parameter in a SymPress config file:

```