From 71fa2d867f3d1671b3eb1cea739858c32828d876 Mon Sep 17 00:00:00 2001 From: Ferry Manders Date: Thu, 12 Apr 2018 10:32:32 +0200 Subject: [PATCH 1/2] AllowOverride explained for apache .htaccess In some apache installations .htaccess is disallowed by default. explained a few fixes/work arounds. --- readme.md | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) diff --git a/readme.md b/readme.md index 5ae0edde..b9126aab 100644 --- a/readme.md +++ b/readme.md @@ -115,8 +115,18 @@ Currently added languages are ## Web Server Configuration ### Apache -A .htaccess file ships with the app, however, if it does not work with your Apache installation, try this alternative: +A .htaccess file ships with the app, however, a lot of apache installations disallow .htaccess files by default. +#### Fixes & work around options +##### - Apache global allow .htaccess +Find the ``AllowOverride None`` line in your apache configuration and change this to ``AllowOverride All`` + +##### - Apache vhost configuration allow .htaccess +In the apache vhost configuration in the ```` block add ``AllowOverride All`` + +##### - Add .htaccess content in apache configuration +You can add the full .htaccess into your apache configuration, this way you do not need to allow .htaccess files. +You can even shorten the content of the .htaccess when inserting it into the apache configuration to : ``` Options +FollowSymLinks RewriteEngine On @@ -125,6 +135,11 @@ RewriteCond %{REQUEST_FILENAME} !-d RewriteCond %{REQUEST_FILENAME} !-f RewriteRule ^ index.php [L] ``` +#### More info +More info about AllowOverride can be found here : +https://httpd.apache.org/docs/2.4/mod/core.html#allowoverride + + ### Nginx If you are using Nginx, the following directive in your site configuration will direct all requests to the index.php front controller: From d81595f43f4abbf997536257c60d1ad7f85edfc8 Mon Sep 17 00:00:00 2001 From: Ferry Manders Date: Thu, 12 Apr 2018 10:36:45 +0200 Subject: [PATCH 2/2] AllowOverride explained for apache .htaccess added extra example so users have a reference --- readme.md | 1 + 1 file changed, 1 insertion(+) diff --git a/readme.md b/readme.md index b9126aab..5d3c26d8 100644 --- a/readme.md +++ b/readme.md @@ -116,6 +116,7 @@ Currently added languages are ### Apache A .htaccess file ships with the app, however, a lot of apache installations disallow .htaccess files by default. +You will notice this due to some links not working like ``/settings``. #### Fixes & work around options ##### - Apache global allow .htaccess