Install

Works with Drupal: ^10.3 || ^11

Using Composer to manage Drupal site dependencies

Alternative installation files

Download tar.gz 46.92 KB
MD5: d60409168eca5f435a6d478bf5c3ead3
SHA-1: 0d8b2b8978824d49d5c3bab17569ee9897d3fd99
SHA-256: accb54f8c48ad63278b426ed95ea6533a9d17b94bde691e8df09a7767a635422
Download zip 67.03 KB
MD5: c24d03827100f162d424122d1baceb9a
SHA-1: 223e95892273c12a2d8b8f2976a1541e2edfb7eb
SHA-256: 8b7e4d2144569534404327b7f05b37b3350c027ff982abc2172a8ef7ee78780b

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:NAME cache 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.

Created by: dinis
Created on: 9 May 2026 at 19:59 UTC
Last updated: 9 May 2026 at 20:00 UTC
Bug fixes

Other releases