test: add live cache backend smoke

Author: brianvarskonst

.github/workflows/backend-smoke.yml

@@ -0,0 +1,54 @@
+name: Cache backend smoke
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  native-backends:
+    name: Redis and Memcached
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    services:
+      redis:
+        image: redis:7.4-alpine@sha256:6ab0b6e7381779332f97b8ca76193e45b0756f38d4c0dcda72dbb3c32061ab99
+        ports:
+          - 6379:6379
+        options: >-
+          --health-cmd "redis-cli ping"
+          --health-interval 5s
+          --health-timeout 3s
+          --health-retries 10
+      memcached:
+        image: memcached:1.6@sha256:dc561d52bb8ad3c038867123ed2dc8357c4c128f047cdbd526cd65cf39408cbd
+        ports:
+          - 11211:11211
+    steps:
+      - name: Checkout
+        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        with:
+          persist-credentials: false
+
+      - name: Set up PHP
+        uses: shivammathur/setup-php@f3e473d116dcccaddc5834248c87452386958240 # v2
+        with:
+          php-version: '8.5'
+          extensions: redis, memcached
+          tools: composer:v2
+          coverage: none
+
+      - name: Install dependencies
+        uses: ramsey/composer-install@65e4f84970763564f46a70b8a54b90d033b3bdda # 4.0.0
+        env:
+          COMPOSER_AUTH: ${{ secrets.COMPOSER_AUTH_JSON }}
+
+      - name: Test native backends
+        run: composer tests:backends
+        env:
+          SYMPRESS_LIVE_CACHE_TESTS: '1'

AGENTS.md

@@ -0,0 +1,37 @@
+# SymPress Framework Bundle agent contract
+
+## Purpose and boundaries
+
+This bundle bridges Symfony FrameworkBundle services into the SymPress kernel and owns the WordPress object-cache drop-in. Cache configuration, backend protocols, signed payloads and drop-in publication are operational and security boundaries.
+
+## Read first
+
+- `Resources/config`: bundle service and package configuration roots.
+- `src/DependencyInjection`: Symfony extension and compiler-pass wiring.
+- `src/ObjectCache`: configuration, adapters, codec, proxy and drop-in installation.
+- `dropin/object-cache.php` and `inc/object-cache-functions.php`: portable WordPress runtime boundary.
+- `CONTRIBUTING.md` and the README operational notes before changing cache behavior.
+
+## Verification
+
+- Fast: `composer tests -- --filter <changed subsystem>`.
+- Full: `composer qa`.
+- Native Redis/Memcached changes: `SYMPRESS_LIVE_CACHE_TESTS=1 composer tests:backends` with both services and PHP extensions available.
+- Drop-in changes require tests for ownership/overwrite behavior and a published-file diff.
+
+## Invariants
+
+- Require a strong `APP_SECRET`; never introduce predictable secret fallbacks.
+- Never overwrite an unmanaged third-party `object-cache.php`.
+- Keep Redis/Memcached counter and group-flush semantics compatible with WordPress.
+- Persistent backend failures must degrade safely without exposing secrets or creating web-accessible control endpoints.
+- Treat backend stores, cache directories and container dumps as trusted infrastructure.
+- Keep service configuration private unless a public entry point is intentional.
+
+## Cross-repository impact
+
+The bundle depends on `sympress/kernel` discovery and container lifecycle. WP Starter may publish the drop-in during setup. Coordinate metadata, service aliases and drop-in path changes with kernel and a runnable WordPress consumer.
+
+## Definition of done
+
+Focused tests and `composer qa` pass; native protocol changes pass the live backend smoke; security/operations docs match behavior; generated or published drop-in content is verified.

README.md

@@ -54,6 +54,14 @@ 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:
+
+```sh
+SYMPRESS_LIVE_CACHE_TESTS=1 composer tests:backends
+```
+
 ## Cache Pool Configuration
 
 The bundle provides defaults that work without project config. Projects can override the `framework.cache` parameter in a SymPress config file:

composer.json

@@ -91,6 +91,10 @@
             "Composer\\Config::disableProcessTimeout",
             "qa tests"
         ],
+        "tests:backends": [
+            "Composer\\Config::disableProcessTimeout",
+            "phpunit --configuration phpunit.xml.dist --group live-cache --no-coverage"
+        ],
         "test": [
             "@tests"
         ],

tests/Integration/NativeObjectCacheBackendSmokeTest.php

@@ -0,0 +1,73 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SymPress\Framework\Tests\Integration;
+
+use PHPUnit\Framework\Attributes\Group;
+use PHPUnit\Framework\TestCase;
+use SymPress\Framework\ObjectCache\NativeMemcachedObjectCacheAdapter;
+use SymPress\Framework\ObjectCache\NativeRedisObjectCacheAdapter;
+
+#[Group('live-cache')]
+final class NativeObjectCacheBackendSmokeTest extends TestCase
+{
+    protected function setUp(): void
+    {
+        if (getenv('SYMPRESS_LIVE_CACHE_TESTS') !== '1') {
+            self::markTestSkipped('Set SYMPRESS_LIVE_CACHE_TESTS=1 to test live cache backends.');
+        }
+    }
+
+    public function testRedisProtocolAndAtomicOperations(): void
+    {
+        self::assertTrue(class_exists(\Redis::class), 'The redis PHP extension is required.');
+        $redis = new \Redis();
+        $this->connect(fn (): bool => $redis->connect('127.0.0.1', 6379, 1.0));
+        $cache = new NativeRedisObjectCacheAdapter($redis, 'sympress-smoke-' . bin2hex(random_bytes(6)));
+
+        self::assertTrue($cache->set('count', 1));
+        self::assertSame(1, $cache->get('count'));
+        self::assertSame(3, $cache->incr('count', 2));
+        self::assertSame(0, $cache->decr('count', 9));
+        self::assertTrue($cache->clear());
+        self::assertFalse($cache->get('count'));
+
+        $redis->close();
+    }
+
+    public function testMemcachedProtocolAndAtomicOperations(): void
+    {
+        self::assertTrue(class_exists(\Memcached::class), 'The memcached PHP extension is required.');
+        $memcached = new \Memcached();
+        self::assertTrue($memcached->addServer('127.0.0.1', 11211));
+        $this->connect(static fn (): bool => $memcached->getVersion() !== false);
+        $cache = new NativeMemcachedObjectCacheAdapter(
+            $memcached,
+            'sympress-smoke-' . bin2hex(random_bytes(6)),
+        );
+
+        self::assertTrue($cache->set('count', 1));
+        self::assertSame(1, $cache->get('count'));
+        self::assertSame(3, $cache->incr('count', 2));
+        self::assertSame(0, $cache->decr('count', 9));
+        self::assertTrue($cache->clear());
+        self::assertFalse($cache->get('count'));
+
+        $memcached->quit();
+    }
+
+    /** @param callable(): bool $probe */
+    private function connect(callable $probe): void
+    {
+        for ($attempt = 0; $attempt < 10; $attempt++) {
+            if ($probe()) {
+                return;
+            }
+
+            usleep(250_000);
+        }
+
+        self::fail('Cache backend did not become ready.');
+    }
+}