page content
How to configure Apache using .htaccess files?
The use of .htaccess files allows a website user to apply an Apache server configuration. To accomplish this the user can upload a .htaccess file containing the configuration directives in the directory she wants. This allows for example to configure the rewriting rules for the URL, to define another character set, to create a protected directory, to put into place a redirection, etc.
Parsing .htaccess files is by default deactivated to enhance the speed of the server. If you wish to install certain configurations yourself, we can activate it in the main configuration of your hosting.
There is a lot of information about how to use .htaccess files within Apache.
- http://httpd.apache.org/docs/2.0/howto/htaccess.html
- http://httpd.apache.org/docs/2.0/howto/auth.html
If your .htaccess files contains a syntax error, it will simply be ignored by the Apache server and you will get a "500 Internal configuration error" in the context visualisation through a browser. In that case you can rename or simply delete the .htaccess file. (Pay extra attention if you work with a MacOS editor to upload your .htaccess files with the UNIX newlines, for example via BBEdit save with UNIX linefeeds.)
Activating .htaccess files is done through the AllowOverride
directive in the main configuration file of Apache. If you have Webmin access for managing your site, it can be activated in the Webmin-Apache module. Do the following steps to restrict the use of .htaccess files to a particular Apache virtual host:
- Go to the Apache module, in the
Virtual Servers
list, select the virtual Apache server you need. - On the following screen
Virtual server options
, go to theDirectory "/var/www/.../public"
section, then click on - Go to
Document options
- Check
Allow Override (AllowOverride)
, activate in the following list only the necessary configuration type directives:- Authentification options
- MIME types and encoding
- Indexing and index file
- Hostname access control
- File options
After changing these options, don't forget to click the « Apply Changes » link (on the top right) to make the Apache server use your changes.