Download the PHP package waffle-commons/cache without Composer
On this page you can find all versions of the php package waffle-commons/cache. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download waffle-commons/cache
More information about waffle-commons/cache
Files in waffle-commons/cache
Package cache
Short Description Cache component for Waffle framework.
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package cache
Waffle Cache Component
Release:
0.1.0-beta5|CHANGELOG.mdPSR Compliance: PSR-6 (Psr\Cache) + PSR-16 (Psr\SimpleCache)
PSR-6 and PSR-16 compliant cache implementation for the Waffle Framework. Designed for FrankenPHP resident worker mode — every adapter is stateless across requests, fail-secure, and zero-baseline under Mago static analysis.
📦 Installation
🧱 Adapters
| Adapter | Use case | Worker scope |
|---|---|---|
ArrayCache |
In-memory, ultra-fast. Lifetime = worker request cycle. | Single worker |
FileCache |
Persistent filesystem cache with strict permission handling (no /tmp foot-guns). |
Per host |
RedisCache |
Distributed cache across multiple FrankenPHP workers via the Predis client. | Cluster-wide |
All adapters implement both Psr\SimpleCache\CacheInterface (PSR-16) and route through the same KeyValidator. CachePool provides the PSR-6 CacheItemPoolInterface view on top of any adapter.
🛡️ Hardening features
- JSON-only payloads (Beta 1):
FileCacheandRedisCacheserialize entries withjson_encode/json_decode— never PHPunserialize. This eliminates the PHP Object Injection → RCE vector (OWASP A08) that native deserialization exposes in a long-lived worker process. JSON parse failures fail-secure (treated as a cache miss). Trade-off: only JSON-encodable values round-trip — objects come back asstdClass/arrays. - Stampede protection (
StampedeAwareTrait): probabilistic early expiration to prevent thundering-herd misses under high load. - Strict key validation (
KeyValidator): enforces the PSR-16 key character set; rejects invalid keys withInvalidCacheKeyException. - Stateless adapters: no per-process mutable state — safe for FrankenPHP worker reuse.
- Fail-secure exceptions:
CacheException,CacheBackendUnavailableException,InvalidCacheKeyException— all rooted in thewaffle-commons/contractsexception hierarchy.
🐘 PHP 8.5 features used
- Typed constants for adapter defaults.
- Asymmetric visibility (
public private(set)) on adapter configuration. - Property hooks for validating constructor inputs at the source.
readonlyclasses for value objects (CacheItem).
🚀 Quick start
Factory-based wiring (preferred in framework code) is provided by CacheFactory.
🧭 Architectural boundary (mago guard)
An active dependency perimeter is enforced on every CI run by vendor/bin/mago guard (bundled into composer mago; zero baselines). The rules live in mago.toml under [guard.perimeter] — a forbidden use statement fails the build, not a reviewer.
Production code under Waffle\Commons\Cache may depend only on:
Waffle\Commons\Cache\**— itselfWaffle\Commons\Contracts\**— the shared contracts package, the only Waffle dependency permittedPredis\**— the Predis client behind theRedisCacheadapterPsr\**— PSR interfaces (PSR-6 / PSR-16)@global+Psl\**— PHP core and the PHP Standard Library
Test code under WaffleTests\Commons\Cache is unrestricted (@all). Structural rules are guarded too: interfaces must be named *Interface, Exception\** classes must end in *Exception, and any Enum\** namespace may hold only enum declarations.
Contract-first, component-agnostic by construction: components compose through waffle-commons/contracts, never directly through one another.
🧪 Testing
PHPUnit 11+ suite targets >= 95% line coverage.
🤝 Contributing
See CONTRIBUTING.md. All contributions must respect the Mago Purge Protocol (zero baselines) and the FrankenPHP statelessness contract.
📄 License
MIT — see LICENSE.md.
