Troubleshooting Guide¶
PLEASE READ
Development on the 3rd party LSCache Purge plugin for Craft CMS has been discontinued:
Per-URL cache busting is now broken in Craft 3.5 because of changes to how template caching works. You will need to nuke the whole cache on save if you are running 3.5+
This plugin is EOL. Minor patches will be issued, but not major functionality overhauls. PR's gratefully received.
We recommend using LSCache with rewrite rules via these instructions if you are using Craft CMS v3.5 or later.
We do our best to document and provide solutions for any situation you may encounter with LiteSpeed Cache plugins. If you don't see your issue listed here, there are additional support options available.
See Also: General LSCache Troubleshooting
Tip
Before contacting the support team, please verify that you have upgraded to the most recent version of the plugin.
Admin Cached Despite Rewrite Rules¶
The rewrite rules specified in the installation instructions should prevent your admin pages from being cached.
If you find that these pages are being cached, it's likely that LSCache has been incorrectly enabled at a global level. You can either correct this by setting Enable Public Cache to not set or no in LiteSpeed Web Server WebAdmin Console, as recommended, or you can disable the global setting for a particular virtual host in .htaccess.
To disable virtual host cache, add the CacheDisable public / line before the rewrite rules, like so:
########## Begin - Litespeed cache
<IfModule LiteSpeed>
RewriteEngine On
CacheDisable public /
RewriteCond %{REQUEST_METHOD} ^HEAD|GET$
RewriteCond %{ORG_REQ_URI} !/admin
RewriteCond %{ORG_REQ_URI} !/index.php/admin
RewriteRule .* - [E=Cache-Control:max-age=28800]
</IfModule>
########## End - Litespeed cache
The CacheDisable public / directive will disable caching sitewide, while[E=Cache-Control:max-age=28800] will selectively enable it for the URLs that match the given conditions, and set their TTL to 28800 seconds (8 hours).