Differences

This shows you the differences between two versions of the page.

--- litespeed_wiki:cache:lscdrupal [2018/03/16 18:14]
Jackson Zhang [500 error]
+++ litespeed_wiki:cache:lscdrupal [2018/12/11 15:42]
Lisa Clarke [Verify/Test if LiteSpeed cache is working or not] Proofreading
@@ Line 1: / Line 1: @@
 ====== LiteSpeed Cache for Drupal 8 ======
+**NOTE: This plugin is only for Drupal 8. If you are running an earlier version of Drupal, you will need to use [[litespeed_wiki:cache:no-plugin-drupal|LSCache via rewrite rules]].**
 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.
@@ Line 13: / Line 15: @@
 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=====
+=====Enable LiteSpeedCache lookup by placing the following to .htaccess at Doc_Root =====
+Place the following into .htaccess:
 <code>
@@ Line 33: / Line 37: @@
   * Check the checkbox next to ''LiteSpeed Cache''.
   * Click **Install**.
+===== Verify LiteSpeed Cache is Working  =====
+Look for the response header ''X-LiteSpeed-Cache: hit'' in the browser developer tools to verify a page is being served from LiteSpeed Cache. Here's how:
+  - Open the Chrome/Firefox developer tools on a non-logged-in browser and navigate to your site. Open the **Network** tab.
+  - Refresh the page.
+  - Click the first resource (this should be an HTML file). The resource's headers should appear, and ''X-LiteSpeed-Cache: hit'' should be among them.
+  - If you see ''X-LiteSpeed-Cache: miss'' instead, refresh the page and check the header again.
+  - If you continue to not see ''X-LiteSpeed-Cache: hit'', it means LiteSpeed is not working or is not enabled properly. Please go back to the beginning and make sure you have carried out each step properly.
 =====Configuration=====
@@ Line 63: / Line 76: @@
-===== Possible Installation Error and fix =====
+===== Troubleshooting =====
-==== 500 error due to PHP version less than 7.1 or missing PHP module packages ====
-Install failed from browser, check the server error log, check your PHP version, if lower than PHP 7.1, it will fail.
-Sometime installation still failed even using PHP 7.1 and above, It could possibly be missing some php modules.
+==== Installation Errors ====
-For example, error log 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...')
+=== 500 error ===
+You may experience a 500 error during installation if:
+  * The PHP version is less than 7.1
+  * PHP module packages are missing
+Check your PHP version. If it's lower than PHP 7.1, installation will fail.
+If it's PHP 7.1 and above, there may be some missing PHP modules. Check the server error log.
+If you see something like this:
+<code>
+[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...')
+</code>
-Install php-pecl-zip package should fix the problem.
+install the ''php-pecl-zip'' package, and that should fix the problem.