apache tutorial - How to use the mod_speling Apache module - apache - apache web server - apache server - apache2
Filename case sensitivity
- A2 Hosting servers run Linux, which has a case-sensitive file system. In other words, file.html and File.html are not the same file. This is different from Microsoft Windows, which does not have a case-sensitive file system. On Microsoft Windows, file.html, File.html, FILE.HTML, and FiLe.Html all refer to the same file. These file handling differences can cause problems, particularly when:
- You migrate a web site from Microsoft IIS (Internet Information Services) to Linux.
- You use an application to design a web site on Microsoft Windows, and then publish the files to a Linux web server.
- You can use the Apache web server's mod_speling module to work around these issues. (The module's name is intentionally misspelled with only one 'l'.)
- With the mod_speling module, you can instruct Apache to ignore filename case.
- This saves you the effort of having to manually rename files and edit HTML hyperlinks so they all use the correct case.
- To set up the mod_speling module, follow the appropriate procedure below for your server's Linux distribution.
Debian and ubuntu
- To enable the mod_speling module on Debian or Ubuntu, follow these steps:
- og in to your server using SSH.
- As the root user, type the following command to enable the mod_speling module:
a2enmod spelingclick below button to copy the code. By Apache tutorial team
- Type the following command to restart Apache:
service apache2 restartclick below button to copy the code. By Apache tutorial team
- The mod_speling module is now enabled. You can use .htaccess directives to control which directories use it to process filenames. To do this, follow these steps:
- Type the following command:
cd /etc/apache2/sites-availableclick below button to copy the code. By Apache tutorial team
- Open your web site configuration file in a text editor, and then make sure that the AllowOverride directive is set to All or Options for the directory or directories that you want.
- To load the new site configuration, type the following command. Replace sitename with the name of your own site configuration file:
a2ensite sitenameclick below button to copy the code. By Apache tutorial team
- Change to the web site directory (for example, /var/www) where you want to use mod_speling processing.
- Create an .htaccess file that includes the following lines:
<IfModule mod_speling.c>
CheckCaseOnly on
CheckSpelling on
</IfModule>click below button to copy the code. By Apache tutorial team
- Test the configuration. For example, if you have a file named test.html, you should now be able to view it in your web browser by specifying Test.html, TEST.html, test.HTML, or any other case combination in the URL.
Centos and fedora
- To enable the mod_speling module on CentOS or Fedora, follow these steps:
- Log in to your server using SSH.
- The mod_speling module may be already loaded by default. To verify if this is the case, type the following command as the root user:
httpd -M | grep spelingclick below button to copy the code. By Apache tutorial team
- If the mod_speling module is enabled, you see the following output:
speling_module (shared)click below button to copy the code. By Apache tutorial team
- If you do not see this output, add the following line to the /etc/httpd/conf/httpd.conf file:
LoadModule speling_module modules/mod_speling.soclick below button to copy the code. By Apache tutorial team
- Then type the following command:
service httpd restartclick below button to copy the code. By Apache tutorial team
- When the mod_speling module is enabled, you can use .htaccess directives to control which directories use it to process filenames. To do this, follow these steps:
- Open the /etc/httpd/conf/httpd.conf file in a text editor, and then make sure that the AllowOverride directive is set to All or Options for the directory or directories that you want.
- If the AllowOverride directive is not set to All or Options, make the change, save the httpd.conf file, and then type the following command to restart the server:
service httpd restartclick below button to copy the code. By Apache tutorial team
- Change to the web site directory (for example, /var/www/html) where you want to use mod_speling processing.
- Create an .htaccess file that includes the following lines:
<IfModule mod_speling.c>
CheckCaseOnly on
CheckSpelling on
</IfModule>click below button to copy the code. By Apache tutorial team
- Test the configuration. For example, if you have a file named test.html, you should now be able to view it in your web browser by specifying Test.html, TEST.html, test.HTML, or any other case combination in the URL.