Install
Works with Drupal: ^10.3 || ^11Using Composer to manage Drupal site dependencies
Alternative installation files
Release notes
Beta1 of the 1.3.x track. Same code as 1.3.0-alpha3 (commit 05f439a) plus a README addition documenting the matching LSWS server-side CacheVary directive. The version bump signals API freeze for the 1.3.x track and asks operators to soak the module ahead of rc1.
What 1.3 ships. Named vary-cookie support on top of 1.2.x's ESI and 1.1.x's private cache. Operators configure cookie names at Configuration › Development › Performance › LSCache; the response subscriber emits X-LiteSpeed-Vary: cookie=NAME for every configured cookie on every cacheable response. LSWS keys its cache by cookie value, holding separate cache entries per variant.
Required matching LSWS server-side directive. The module-side header is necessary but not sufficient. LSWS must also be told to honour the vary cookie via a matching CacheVary cookie=NAME directive at the server or vhost level (not in .htaccess). Without this, the header is emitted correctly but LSWS will not actually key its cache by cookie value. The README has been expanded to walk through the LSWS configuration and a verification curl sequence.
Field-test history through alpha cycle. Adopter-side testing on a real-traffic Drupal 11 + LSWS install across alpha2 and alpha3:
- Two bugs found and fixed in alpha3: ESI fragments stripped to empty (forward-port from 1.2.0-alpha3); vary cookies inert because the emission logic required a matching
cookies:NAMEcache context. Both fixed in alpha3 and verified clean in the re-test. - Vary-cookie emission verified across no-cookie / mobile / desktop request variants: header now present in all three, with the correct cookie list.
- Cumulative checks clean: ESI surface, vary-cookie surface, inherited 1.1 admin-route skip, cache-poisoning canary all verified.
Cumulative with 1.1.x and 1.2.x. 1.3.0-beta1 contains all of 1.0.x stable code, all of 1.1.x's private cache, all of 1.2.x's ESI, and 1.3.x's vary cookies. Operators wanting to validate the entire 1.x feature line on a single install can soak this build.
Stability commitment. The vary_cookies config schema and the X-LiteSpeed-Vary emission contract are stable from this release forward. Subsequent 1.3.x releases on the path to 1.3.0 stable will be bug-fix only.
Known issue. Post-PURGE re-cache flake on responses without ESI markup, observed by the adopter during the alpha3 re-test. Could not be isolated; may be unrelated noise from concurrent purge cron, or an LSWS-side interaction with response-header shape. Flagged for further investigation; not blocking beta1.
Upgrading from 1.3.0-alpha3. composer require drupal/lscache:1.3.0-beta1. No code changes; no database updates; no configuration changes; no .htaccess changes. Operators using vary cookies should review the new Required matching LSWS server-side directive section of the README and ensure their LSWS config includes the matching CacheVary directive.
Reporting issues. Use the issue queue, tagged against version 1.3.x-dev. Suspected security issues should go to security@drupal.org rather than a public issue.