Download the PHP package charcoal/cache without Composer
On this page you can find all versions of the php package charcoal/cache. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package cache
Charcoal Cache
The Cache package provides an integration with Stash for caching the results of expensive tasks.
Installation
For Charcoal projects, the service provider can be registered from your configuration file:
Overview
Service Provider
Parameters
- cache/available-drivers: Collection of registered cache drivers that are supported by this system (via
Stash\DriverList
).
Services
- cache/config: Configuration object for the caching service.
See Pool Configuration for available options. - cache/drivers: Collection of cache driver instances (as a service container) which uses
cache/available-drivers
.
These drivers are pre-configured: - cache/builder: Instance of
CacheBuilder
that is used to build a cache pool. - cache/driver: Reference to the Stash cache driver used by
cache
. Defaults to "memory". - cache: Main instance of the Stash cache pool which uses
cache/driver
andcache/config.prefix
.
Configuration
Pool Configuration
Each pool comes with a set of default options which can be individually overridden.
Setting | Type | Default | Description |
---|---|---|---|
active | boolean |
TRUE |
Whether to enable or disable the cache service. |
prefix | string |
charcoal |
Name of the main Stash pool. |
types | string[] |
memory |
List of cache drivers to choose from for the main Stash pool. Defaults to "memory". |
default_ttl | integer |
1 week | Default time-to-live (in seconds) for a cached item. Currently, only used by the APC driver (cache/drivers.apc ). |
Driver Configuration
Each driver comes with a set of default options which can be individually overridden.
—N/A—
Usage
Just fetch the default cache pool service:
Or a custom-defined cache pool:
Then you can use the cache service directly:
See the Stash documentation for more information on using the cache service.
Middleware
The PSR-6 cache pool and returns that cached response if still valid.
If you are using charcoal/app, you can add the middleware via the application configset:
Otherwise, with Slim, for example:
The middleware comes with a set of default options which can be individually overridden.
Setting | Type | Default | Description |
---|---|---|---|
active | boolean |
FALSE |
Whether to enable or disable the middleware (charcoal/app only). |
cache | CacheItemPoolInterface |
cache |
Required; The main Stash pool. |
ttl | string[] |
1 week | Time-to-live (in seconds) for a cached response. |
methods | string[] |
GET |
Accepted HTTP method(s) to cache the response. |
status_codes | integer[] |
200 | Accepted HTTP status code(s) to cache the response. |
included_path | string[] |
* |
Accepted URI paths for caching the response. |
excluded_path | string[] |
^/admin\b |
Rejected URI paths for caching the response. |
included_query | string[] |
NULL |
Accepted query parameters for caching the response. |
excluded_query | string[] |
NULL |
Rejected query parameters for caching. |
ignored_query | string[] |
NULL |
Ignored query parameters for caching the response. |
By Default
All HTTP responses are cached unless:
- the request method is not GET
- the request URI path starts with
/admin…
- the request URI contains a query string
- the response is not OK (200)
Ignoring Query Strings
If query strings don't affect the server's response, you can permit caching of requests by ignoring all query parameters:
or some of them:
Helpers
CachePoolAwareTrait
The CachePoolAwareTrait
is offered as a convenience to avoid duplicate / boilerplate code. It simply sets and gets an instance of \Psr\Cache\CacheItemPoolInterface
.
Assign a cache pool with setCachePool()
and retrieve it with cachePool()
.
Both methods are protected; this trait has no public interface.
Resources
All versions of cache with dependencies
charcoal/config Version ^5.0
pimple/pimple Version ^3.0
psr/cache Version ^1.0
tedivm/stash Version ~0.16