Merge pull request #169 from ferrymanders/master

AllowOverride explained for apache .htaccess
This commit is contained in:
KodeStar
2018-04-17 09:03:41 +01:00
committed by GitHub

View File

@@ -115,8 +115,19 @@ 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.
You will notice this due to some links not working like ``/settings``.
#### 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 ``<Directory />`` 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 +136,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: