Skip to content

Configuration parameters

Every setting under Settings → Speed Boost maps to a Shopware system_config key under the namespace P2LabCache.config.<name>. You can override them in config/services.yaml, through the admin UI, or via the System Config API.

Dashboard tab

Key	Type	Default	Notes
`active`	bool	`true`	Master cache toggle
`cacheMode`	enum	`basic`	`basic` / `advanced` — dashboard preset
`serverTtl`	int	`86400`	Server-side TTL, seconds
`cacheControlDirectiveMaxAge`	int	`0`	`Cache-Control: max-age=…`
`cacheControlDirectiveSMaxAge`	int	`21600`	`Cache-Control: s-maxage=…`
`cdnCacheControlMaxAge`	int	`0`	`CDN-Cache-Control: max-age=…` (Cloudflare / Fastly / Akamai)
`listingLoadMode`	enum	`skeleton`	`skeleton` / `background`
`listingBackgroundReplacement`	enum	`none`	`none` / `fade`
`cacheHomePage`	bool	`true`	Cache `frontend.home.page`
`cacheNavigationPages`	bool	`true`	Cache `frontend.navigation.page`
`cacheNavigationAjaxPage`	bool	`true`	Cache `frontend.navigation.page.ajax`
`cacheNavigationAjaxFilter`	bool	`true`	Cache `frontend.navigation.filter`
`cacheProductPages`	bool	`true`	Cache `frontend.detail.page`
`cacheCmsPages`	bool	`true`	Cache `frontend.cms.page`
`cacheAsyncBuybox`	bool	`false`	Cache async-buybox response
`ignoredQueryParams`	string[]	(built-in list)	Stripped from cache key

Core tab

Key	Type	Default	Notes
`invalidationMode`	enum	`smart`	`manual` / `request` (Basic) / `extended` / `precise` / `smart`
`enableInvalidationLog`	bool	`false`	Records every invalidation event
`debugMode`	bool	`false`	Adds `X-P2Lab-Cache-*` headers
`cacheAdapter`	enum	`filesystem`	`filesystem` / `redis` / `apcu`
`redisDsn`	string	`''`	e.g. `redis://localhost:6379`
`cacheNamespace`	string	`p2lab_cache`	Backend key prefix
`enableCompression`	bool	`true`	gzip the stored payload
`compressionLevel`	int	`6`	`1` / `3` / `6` / `9`

Reverse proxy tab

Key	Type	Default	Notes
`enableVarnishCache`	bool	`true`	Send xkey purges to Varnish
`xkeyInvalidationStrategy`	enum	`smart`	`default` / `precise` / `smart`
`splitXkey`	bool	`false`	Split long xkey into multiple headers
`shortenXkeyTags`	bool	`false`	MD5-hash long tag names
`enableReverseProxyLog`	bool	`false`	Records every xkey purge
`xkeyTagBlocklist`	string[]	`[]`	Categories to exclude from xkey purges

Xkey tag blocklist categories

Value	Excludes tags matching
`theme`	`theme.*`
`translator`	`translator.*`
`config`	`config.`, `system-config-`
`route`	`-route-`
`snippet`	`snippet-*`
`rule`	`rule-*`
`media`	`media-*`
`property_group`	`property-group-*`
`manufacturer`	`manufacturer-*`
`sales_channel`	`sales-channel-*`
`product_stock`	`p2c-product-stock_*`

Setting values programmatically

$this->systemConfigService->set(
    'P2LabCache.config.invalidationMode',
    'smart',
    $salesChannelId   // null for global
);

Per-sales-channel overrides

Every key supports per-sales-channel override. From the admin, use the page-header sales-channel switcher and toggle “Override”. From the API, pass the sales-channel ID as the third argument to systemConfigService->set().