Configuration¶
Configuration is optional. Once the module is activated, your cache is already up and running, but you can customize a few settings on the configuration screen, if you wish.
Visit http://example.com/admin/config/development/lscache
.
LSCache of This Site¶
Clear this site¶
It is not necessary to clear the cache under normal everyday usage. Content can be added and edited on your site and LSCache will clear the impacted pages automatically.
If, however, you are upgrading your website, changing the site theme and/or logo, adding a new extension, etc, you will want to clear the whole cache then. Use this button to do so.
This option only clears the current Drupal installation. If you have multiple Drupal installations on the same virtual host, they will not be affected.
Warm up this site¶
Warms up the public cache of this Drupal installation. If you have multiple Drupal installations on the same virtual host, they will not be affected. If Private Cache Status is set to ON
, private cache will also be warmed up.
LSCache Settings¶
The settings in this section refer to public cache.
Cache Status¶
This should be On
if you want to use LSCache. Turn it Off
to stop caching your site.
Public Cache TTL¶
This value determines the number of seconds the pages on your Drupal site can remain in cache before they are considered out-of-date. Default is 64800
, the equivalent of 18 hours.
Debug¶
If turned On
, LiteSpeed Cache will emit extra headers for testing while developing or deploying.
Private Cache for Logged in Users¶
LiteSpeed Cache supports ESI, so that you may include blocks of privately cached content on public pages for logged in users.
To learn more about what ESI is and how it works, please see ESI (Edge Side Includes).
Private Cache Status¶
This should be On
if you want to create privately cached ESI blocks for logged-in users. Turn it Off
to stop using private cache.
Private Cache TTL¶
This value determines the number of seconds the privately cached ESI blocks on your Drupal site can remain in cache before they are considered out-of-date. Default is 3600
, the equivalent of 1 hour.
ESI Blocks Setting¶
Privately cached ESI blocks are identified by their div id
s. To treat particular div
s as ESI blocks, enter them in the text box, one per line.
Example
To make the following div
an ESI Block, enter it in the ESI Blocks Setting as id=bar-administrator
<div id="bar-administrator">...<div>
CLI Commands¶
CLI commands may be executed from the website host server through the drush lscache
command in the /drupal_root/vendor/bin
folder.
Purge All Cache¶
Clears the cache for the specified site.
Command: purgeall
Example
Purge all cache from example.com
:
./drush lscache:purgeall example.com
cURL alternative:
curl -N "http://example.com/lscpurgeall"
Warm Up Whole Website¶
Warms up the cache for the specified site.
Command: warmup
Example
Warm up the cache for example.com
:
./drush lscache:warmup example.com
cURL alternative:
curl -N "http://example.com/lscwarmup"
Note
The CLI warmup
command can only warm up public page caches. If you want to warm up private cache, you need to use the Warm up this site button in the Web GUI's LSCache admin panel.