Rewrite Rule Differences

From OpenLiteSpeed Wiki

Revision as of 20:27, 12 December 2014 by Marmstrong (talk | contribs)

For rewrite rules, OpenLiteSpeed uses the same syntax as Apache's mod_rewrite. Apache rewrite rules can be copied and pasted into OpenLiteSpeed's Rewrite Rules field (WebAdmin > Configuration > Virtual Hosts > your virtual host > Rewrite > Rewrite Rules).

It should be noted, though, that Apache mod_rewrite syntax is slightly different when a rewrite rule is in an .htaccess file as opposed to virtual host configuration (in an httpd.conf file). OpenLiteSpeed rewrite should be written in this vhost config syntax. If you are copying a set of rewrite rules from an Apache .htaccess file to OpenLiteSpeed, use the following guidelines to edit the rules so they conform to vhost config syntax.

Conversion Guidelines

RewriteBase is not supported in virtual host configurations

The RewriteBase directive can only be used in .htaccess rewrite rules and thus is not supported in OpenLiteSpeed virtual host configurations. (It can be used in an OpenLiteSpeed Context, but is usually not necessary, since the URL prefix is stipulated in the Context's URI and Location settings.)

Add a forward slash at the beginning of the rule pattern

In a virtual host configuration, the rewrite rule pattern will initially be matched against the part of the URL after the hostname and port and before the query string (e.g. "/app1/index.html"). This part of the URL does not end in a forward slash, so the pattern needs to start with a forward slash. Rewrite rules in an .htaccess file are matched against the file system path, which does end in a forward slash. Thus .htaccess rewrites do not begin with a forward slash, but OpenLiteSpeed rewrites should begin their pattern with a forward slash. See the following example:

In an .htaccess file:

RewriteRule ^([a-zA-Z0-9_-]+)$$1/ [R=301,L]

In a virtual host configuration (and in OpenLiteSpeed):

RewriteRule ^/([a-zA-Z0-9_-]+)$$1/ [R=301,L]