spiral/roadrunner-kv
PSR-16 cache bridge for the RoadRunner KV plugin. Install via Composer, configure one or more kv drivers in RoadRunner, then use Spiral\RoadRunner\KeyValue\Factory over RPC to select a named store and set, get, or delete cached values. Ideal for RoadRunner-powered PHP apps.
Architecture fit: Still requires an existing RoadRunner runtime with the KV plugin enabled. v4.5.0 improves fit for applications on RoadRunner v3, including Laravel/Symfony workers, but remains unsuitable for traditional PHP-FPM or non-RoadRunner stacks.
Integration feasibility: High for teams already on RoadRunner v3. Integration remains Composer install plus client instantiation and KV plugin configuration, but the package is now renamed to roadrunner/kv, so existing dependency declarations, lockfiles, CI scripts, and internal docs must be updated.
Technical risk: The package rename is a practical breaking change at the dependency/CI layer even though it appears in a minor release. RoadRunner v3 support reduces runtime compatibility risk but introduces version-alignment risk across RoadRunner runtime, KV plugin, and package. Community adoption still appears low, with limited public production evidence. Confirm whether the old package name remains aliased and whether namespaces/autoload paths changed.
Key questions:
Stack fit: Best for Laravel/PHP applications already running under RoadRunner v3. Not compatible with traditional PHP-FPM or non-RoadRunner deployments without introducing RoadRunner and the KV plugin.
Migration path: Start with a non-critical worker-state use case. Update Composer requirements to roadrunner/kv, refresh lockfiles and CI, align RoadRunner v3 and KV plugin versions, then validate client behavior before replacing existing Redis/cache usage. Existing users should treat the rename as a dependency migration, not a drop-in minor upgrade.
Compatibility: v4.5.0 adds RoadRunner v3 support, so compatibility with older RoadRunner versions must be verified before upgrading. The package rename may break existing Composer constraints, build scripts, and documentation references. Confirm namespace and configuration compatibility separately from the Composer package name.
Sequencing: Inventory current RoadRunner/plugin versions; upgrade runtime and KV plugin first if needed; switch Composer dependency to roadrunner/kv; run integration and failure-mode tests; canary a low-risk workload; then expand usage. Avoid bundling the package rename with unrelated runtime upgrades.
Maintenance: The rename requires runbook, dependency, and CI updates. Pin package, RoadRunner, and plugin versions together and monitor upstream releases. The v4.5.0 release indicates continued maintenance, but low adoption still limits community troubleshooting.
Support: Expect limited external support and reliance on upstream RoadRunner documentation. Assign an internal owner for upgrade validation and incident response.
Scaling: Performance and scaling depend heavily on the KV backend and RoadRunner worker configuration. Validate under expected concurrency before using for shared worker state or cache-like workloads.
Failure modes: Primary risks include KV backend outage, plugin misconfiguration, RoadRunner/plugin/package version mismatch, Composer rename breakage, and hidden serialization or key-size limits. Define fallback behavior for non-critical vs. critical state.
Ramp-up: Moderate for teams already operating RoadRunner; high for teams new to RoadRunner or KV semantics. Ramp-up should include upgrade rehearsal, failure injection, and clear guidance on when not to use the package.
How can I help you explore Laravel packages today?