Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
litespeed_wiki:cache:lscdrupal [2018/03/16 18:11] Jackson Zhang [Public Cache TTL] |
litespeed_wiki:cache:lscdrupal [2020/08/19 18:29] (current) Lisa Clarke Redirect to new Documentation Site |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== LiteSpeed Cache for Drupal 8 ====== | + | ~~REDIRECT>https://docs.litespeedtech.com/lscache/lscdrupal/overview/~~ |
- | + | ||
- | Drupal 8 is significantly changed from Drupal 7. The developers switched from procedural programming to object-oriented programming. Drupal 8 has a built-in page cache (for static content) and a dynamic page cache for logged in users. The latter basically works as a reverse proxy written in PHP. The built-in proxy is good if you have no other options, however, with the LiteSpeed Cache plugin you will see a great improvement in performance for your Drupal 8 site. | + | |
- | + | ||
- | Visit [[https://www.litespeedtech.com/products/cache-plugins|our website]] for more information about our cache plugins. | + | |
- | + | ||
- | See also: [[https://github.com/litespeedtech/lscache-drupal|LSCache for Drupal on Github]] | + | |
- | + | ||
- | =====Prerequisites===== | + | |
- | This version of LiteSpeed Cache requires **Drupal 8.xx** or later and **LiteSpeed Web Server (LSWS) 5.2.3** or later, **PHP 7.1** or higher. | + | |
- | + | ||
- | =====Download===== | + | |
- | Download the LiteSpeed Cache Module to your local computer from [[https://github.com/litespeedtech/lscache-drupal/archive/master.zip|our GitHub repository]]. | + | |
- | + | ||
- | =====Enable LiteSpeedCache using rewrite rules===== | + | |
- | + | ||
- | <code> | + | |
- | <IfModule LiteSpeed> | + | |
- | CacheLookup on | + | |
- | </IfModule> | + | |
- | </code> | + | |
- | + | ||
- | =====Install Plugin===== | + | |
- | Once you have downloaded the plugin, you can install by visiting ''<nowiki>http://example.com/admin/modules/install</nowiki>'' (where ''example.com/'' is your site's domain). | + | |
- | + | ||
- | The above import method requires that you have the Drupal core module ''Update manager'' enabled. Without it, the above link may not work. | + | |
- | + | ||
- | Using the **Browse** button you can upload the plugin you just downloaded and start the installation. Once installed, enable the plugin by visiting ''<nowiki>http://example.com/drupal/admin/modules</nowiki>'' | + | |
- | + | ||
- | {{:litespeed_wiki:cache:lscdrupal-install.png?800|}} | + | |
- | + | ||
- | * Use the search box to search for a module. | + | |
- | * Check the checkbox next to ''LiteSpeed Cache''. | + | |
- | * Click **Install**. | + | |
- | + | ||
- | =====Configuration===== | + | |
- | + | ||
- | This step is optional. Once the plugin is activated, your cache is already up and running, but on the configuration screen, you can customize a few settings. | + | |
- | + | ||
- | Visit ''<nowiki>http://example.com/admin/config/development/lscache</nowiki>''. | + | |
- | + | ||
- | {{ :litespeed_wiki:cache:configure-lscache.png?800 |}} | + | |
- | + | ||
- | ====Clear Cache==== | + | |
- | + | ||
- | ===Clear this site=== | + | |
- | + | ||
- | This option only clears the current Drupal installation. This helps if you have multiple Drupal installations on the same virtual host. | + | |
- | + | ||
- | ===Clear all=== | + | |
- | + | ||
- | This button clears the entire LiteSpeed cache for this virtual host. This includes any other web apps using LSCache (WordPress, XenForo, etc.) on this vhost. | + | |
- | + | ||
- | ====Debug==== | + | |
- | + | ||
- | If turned on, LiteSpeed Cache will emit extra headers for testing while developing or deploying. | + | |
- | + | ||
- | + | ||
- | + | ||
- | ====Public Cache TTL==== | + | |
- | + | ||
- | Amount of time LiteSpeed Web Server will save pages in the public cache. | + | |
- | + | ||
- | + | ||
- | ===== Possible Installation Error and fix ===== | + | |
- | ==== 500 error ==== | + | |
- | Install failed from browser, check the server error log, it shows: | + | |
- | [STDERR] Error: Class 'ZipArchive' not found in /var/www/html/core/lib/Drupal/Core/Archiver/Zip.php on line 30 #0 /var/www/html/core/lib/Drupal/Core/Archiver/ArchiverManager.php(42): Drupal\Core\Archiver\Zip->__construct('/tmp/lscache-dr...') | + | |
- | + | ||
- | Install php-pecl-zip package should fix the problem. | + |