{"id":8754,"date":"2014-12-08T18:49:38","date_gmt":"2014-12-08T18:49:38","guid":{"rendered":"https:\/\/wp.okra.host\/article\/rewrite-rules-fail-on-subdirectories-subdomains-or-addon-domains\/"},"modified":"2021-03-07T14:49:28","modified_gmt":"2021-03-07T13:49:28","slug":"rewrite-rules-fail-on-subdirectories-subdomains-or-addon-domains","status":"publish","type":"ht_kb","link":"https:\/\/kb.okra.host\/de\/article\/rewrite-rules-fail-on-subdirectories-subdomains-or-addon-domains\/","title":{"rendered":"Rewrite rules fail on subdirectories, subdomains, or addon domains"},"content":{"rendered":"<h2 id=\"overview\" >Overview<\/h2>\n<p>Rewrite rules remap a URL to another location or resource accessible on a web site. These rules are located in <a title=\".htaccess Guide\" href=\"https:\/\/kb.okra.host\/guides\/htaccess-guide\/\">.htaccess<\/a> files. A common\u00a0snippet looks similar to:<\/p>\n<pre>RewriteEngine On\r\nRewriteCond %{REQUEST_FILENAME} ! -f\r\nRewriteRule ^(.*)$ index.php [QSA, L]<\/pre>\n<p>When located anywhere else besides the <a title=\"Where is site content served from?\" href=\"https:\/\/kb.okra.host\/web-content\/where-is-site-content-served-from\/\">document root<\/a> of the primary domain name, rewrite rules will fail yielding an <a title=\"Accessing web page views and error messages\" href=\"https:\/\/kb.okra.host\/web-content\/accessing-page-views-and-error-messages\/\">Internal Server Error<\/a>.<\/p>\n<h2 id=\"cause\" >Cause<\/h2>\n<p>Rewrite rules modify the URL relative to a document root defined in\u00a0the web server configuration as <em>DocumentRoot<\/em>. Each site may have one\u00a0<em>DocumentRoot<\/em> defined and this value is always\u00a0<code>\/var\/www\/html<\/code>. Additional domains, subdomains, and resources located under\u00a0<code>\/var\/www\/html<\/code> are subject to filesystem remaps outside the location of\u00a0<em>DocumentRoot<\/em>. <code>RewriteBase<\/code> is necessary to anchor a rule set to the new filesystem location.<\/p>\n<h2 id=\"solution\" >Solution<\/h2>\n<p>Inside the <a title=\".htaccess Guide\" href=\"https:\/\/kb.okra.host\/guides\/htaccess-guide\/\">.htaccess<\/a>, immediately following\u00a0<code>RewriteEngine On<\/code>, add\u00a0<code>RewriteBase \/<\/code> or if the .htaccess resides under a subdirectory that\u00a0<em>also appears in the URL path<\/em>, then use that directory in the URL path, e.g. http:\/\/example.com\/mysubsite .htaccess rewrite rules would require\u00a0<code>RewriteBase \/mysubsite<\/code> as opposed to\u00a0<code>RewriteBase \/<\/code>.<\/p>\n<p>A revised example of the earlier snippet would read as follows:<\/p>\n<pre>RewriteEngine On\r\nRewriteBase \/\r\nRewriteCond %{REQUEST_FILENAME} ! -f\r\nRewriteRule ^(.*)$ index.php [QSA, L]\r\n<\/pre>\n","protected":false},"excerpt":{"rendered":"<p>Overview Rewrite rules remap a URL to another location or resource accessible on a web site. These rules are located in .htaccess files. A common\u00a0snippet looks similar to: RewriteEngine On RewriteCond %{REQUEST_FILENAME} ! -f RewriteRule ^(.*)$ index.php [QSA, L] When located anywhere else besides the document root of the primary&#8230;<\/p>\n","protected":false},"author":1,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":{"footnotes":""},"ht-kb-category":[54],"ht-kb-tag":[],"class_list":["post-8754","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-web-content"],"_links":{"self":[{"href":"https:\/\/kb.okra.host\/de\/wp-json\/wp\/v2\/ht-kb\/8754","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/kb.okra.host\/de\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/kb.okra.host\/de\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/kb.okra.host\/de\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/kb.okra.host\/de\/wp-json\/wp\/v2\/comments?post=8754"}],"version-history":[{"count":1,"href":"https:\/\/kb.okra.host\/de\/wp-json\/wp\/v2\/ht-kb\/8754\/revisions"}],"predecessor-version":[{"id":8755,"href":"https:\/\/kb.okra.host\/de\/wp-json\/wp\/v2\/ht-kb\/8754\/revisions\/8755"}],"wp:attachment":[{"href":"https:\/\/kb.okra.host\/de\/wp-json\/wp\/v2\/media?parent=8754"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/kb.okra.host\/de\/wp-json\/wp\/v2\/ht-kb-category?post=8754"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/kb.okra.host\/de\/wp-json\/wp\/v2\/ht-kb-tag?post=8754"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}