Difference between revisions of "Htaccess: Redirect"

From The Uniform Server Wiki
Jump to navigation Jump to search
m (Reverted edits by Upazixorys (Talk); changed back to last version by Ric)
(Punctuation and grammatical changes; some clarification.)
Line 20: Line 20:
 
'''Redirect'''
 
'''Redirect'''
  
The htaccess command Redirect is very powerful you can redirect files or complete folders. Why would you want to do this a typical example would be that you have changed the structure of your site but wish old links (saved by a user) to be redirected to your new page location or even new page name.
+
The htaccess command Redirect is very powerful. You can redirect files or complete folders. Why would you want to do this? A typical example would be that you have changed the structure of your site but want to have old links (saved by a user) to be redirected to your new page location, or even a new page name.
  
 
== Redirect format ==
 
== Redirect format ==
The redirect command must be on a single line with each element separated by a space it has the following format:
+
The redirect command must be on a single line with each element, separated by a space. It has the following format:
  
 
:'''Redirect old_path new_path'''
 
:'''Redirect old_path new_path'''
Line 45: Line 45:
  
 
=== Folder Redirect ===
 
=== Folder Redirect ===
Suppose that all you have done is renamed a folder (and even moved it to another location) however all the files still have their original names redirecting a folder is similar to the above for example:
+
Suppose that all you have done is to rename a folder (and possibly moved it to another location); however all the files still have their original names. Redirecting a folder is similar to the above; for example:
  
 
'''Redirect /olddirectory <nowiki>http://yoursite.com/newdirectory</nowiki>'''
 
'''Redirect /olddirectory <nowiki>http://yoursite.com/newdirectory</nowiki>'''
Line 59: Line 59:
 
</ol>
 
</ol>
  
'''''[[#top | Top]]'''''
 
 
== Directory example 1 ==
 
== Directory example 1 ==
 
Using our '''errors folder''' make a copy of it and rename it to '''moved'''.
 
Using our '''errors folder''' make a copy of it and rename it to '''moved'''.
Line 105: Line 104:
 
# You will be redirected to the folder '''<nowiki>http://localhost/moved/</nowiki>'''
 
# You will be redirected to the folder '''<nowiki>http://localhost/moved/</nowiki>'''
  
'''''[[#top | Top]]'''''
 
 
== Directory example 2 ==
 
== Directory example 2 ==
Open the file '''not_found.html''' contained in folder moved add some more text to distinguish it from the original.
+
Open the file '''not_found.html''' contained in folder that was moved and add some more text to distinguish it from the original.
  
 
'''Testing'''
 
'''Testing'''
Line 114: Line 112:
 
# You will be redirected to the file '''<nowiki>http://localhost/moved/not_found.html</nowiki>'''
 
# You will be redirected to the file '''<nowiki>http://localhost/moved/not_found.html</nowiki>'''
  
Well you get the idea experiment with files it is similar to the folder example.
+
Well, you get the idea. Experiment with files; it is similar to the folder example.
  
'''''[[#top | Top]]'''''
 
 
== Practical Example ==
 
== Practical Example ==
I was faced with this very problem UniCenter has been around for nearly two years and started to become unmanageable hence the move over to the Wiki. Many web sites link to various pages on UniCenter to avoid frustration of not finding an article; users are redirected to the appropriate page on the Wiki.
+
I was faced with this very problemUniCenter has been around for nearly two years and started to become unmanageable, hence the move over to the Wiki. Many web sites link to various pages on UniCenter, so to avoid the frustration of not finding an article, users are redirected to the appropriate page on the Wiki.
  
Below is a small extract from my .htaccess file you will see I am using page redirection:  
+
Below is a small extract from my .htaccess file, where you will see I am using page redirection:  
  
 
<pre>
 
<pre>
Line 134: Line 131:
 
</pre>
 
</pre>
  
'''''Tip'':''' I first publish the Wiki pages, use a browser to view a page and copy the link into .htaccess. Similar process to obtain the redirected page.
+
'''''Tip'':''' I first publish the Wiki pages. Then I use a browser to view a page and copy the link into .htaccess. The process is similar to obtain the redirected page.
  
 
=== Errors ===
 
=== Errors ===
Line 142: Line 139:
 
The server encountered an internal error or misconfiguration and was unable to complete your request.
 
The server encountered an internal error or misconfiguration and was unable to complete your request.
 
</pre>
 
</pre>
 
+
Remember to always make small changes to .htaccess and then test. This makes it easier to isolate and resolve any problems.
Hence always make small changes to .htaccess and then test, makes it easier to isolate and resolve any problems.
 
 
    
 
    
'''''[[#top | Top]]'''''
 
 
----
 
----
  

Revision as of 19:43, 5 April 2011

MPG UniCenter

.htaccess: Introduction | Site error documents | Prevent Directory Listing | Redirect | Preventing hot linking |

.htaccess - Apache directory-level configuration file

Redirect

The htaccess command Redirect is very powerful. You can redirect files or complete folders. Why would you want to do this? A typical example would be that you have changed the structure of your site but want to have old links (saved by a user) to be redirected to your new page location, or even a new page name.

Redirect format

The redirect command must be on a single line with each element, separated by a space. It has the following format:

Redirect old_path new_path

File Redirect format

Looking at this in a little more detail using this example

Redirect /olddirectory/oldfile.html http://yoursite.com/newdirectory/newfile.html

  1. Redirect
    • This is the Apache command followed by a space
  2. /olddirectory/oldfile.html
    • This is the path to the old file you want redirected
    • It is stated in a relative file format
    • Again followed by a space
  3. http://yoursite.com/newdirectory/newfile.html
    • This is the full (URL) path of the location you want the request redirected to

You would place a Redirect command in the root htaccess file for each file you want to redirect.

Folder Redirect

Suppose that all you have done is to rename a folder (and possibly moved it to another location); however all the files still have their original names. Redirecting a folder is similar to the above; for example:

Redirect /olddirectory http://yoursite.com/newdirectory

  1. Redirect
    • This is the Apache command followed by a space
  2. /olddirectory
    • This is the path to the old directory you want redirected
    • It is stated in a relative file format
    • Again followed by a space
  3. http://yoursite.com/newdirectory
    • This is the full (URL) path of the location you want the request redirected to

Directory example 1

Using our errors folder make a copy of it and rename it to moved.

Comment Code
  1. Navigate to the root folder www.
  2. Open the .htaccess file
  3. Add the command shown on the right last line.
  4. Save the file
# This file provides security to the server limiting access to the localhost only.
# Comment to deactivate.

Order Deny,Allow
Deny from all
Allow from 127.0.0.1

# To allow execution of cgi scripts in this directory uncomment next two lines.

AddHandler cgi-script .pl .cgi
Options +ExecCGI

# To unlock your server, comment the next 4 lines.
# Defaults: Username = admin; Password = userver

#AuthName "Uniform Server - Secure Server Access"
#AuthType Basic
#AuthUserFile /htpasswd/www/.htpasswd
#Require valid-user

Redirect /old http://localhost/moved

Testing

  1. Run the server using Server_Start.bat
  2. In the browser address bar type http:/localhost/old
  3. You will be redirected to the folder http://localhost/moved/

Directory example 2

Open the file not_found.html contained in folder that was moved and add some more text to distinguish it from the original.

Testing

  1. Run the server using Server_Start.bat
  2. In the browser address bar type http:/localhost/old/not_found.html
  3. You will be redirected to the file http://localhost/moved/not_found.html

Well, you get the idea. Experiment with files; it is similar to the folder example.

Practical Example

I was faced with this very problem. UniCenter has been around for nearly two years and started to become unmanageable, hence the move over to the Wiki. Many web sites link to various pages on UniCenter, so to avoid the frustration of not finding an article, users are redirected to the appropriate page on the Wiki.

Below is a small extract from my .htaccess file, where you will see I am using page redirection:

Redirect /us_35_apps/joomla/joomla_install_1.html http://wiki.uniformserver.com/index.php/Installing_Joomla
Redirect /us_35_apps/joomla/joomla_install_2.html http://wiki.uniformserver.com/index.php/Joomla_Portability

Redirect /u35_mod_ssl_2/4_hmailserver.html http://wiki.uniformserver.com/index.php/SSL_Part_2:_Installing_hMailServer
Redirect /u35_mod_ssl_2/5_hmailserver.html http://wiki.uniformserver.com/index.php/SSL_Part_2:_Configure_hMailServer

Redirect /new_users/new_users_index.html http://wiki.uniformserver.com/index.php/New_Users:_Home
Redirect /new_users/new_users_install_1.html http://wiki.uniformserver.com/index.php/New_Users:_Quick_Install_Guide
Redirect /new_users/problems_1.html http://wiki.uniformserver.com/index.php/New_Users:_Problems_Section

Tip: I first publish the Wiki pages. Then I use a browser to view a page and copy the link into .htaccess. The process is similar to obtain the redirected page.

Errors

Any typos in the .htaccess file will cause Apache to spit out the following error message:

Internal Server Error
The server encountered an internal error or misconfiguration and was unable to complete your request.

Remember to always make small changes to .htaccess and then test. This makes it easier to isolate and resolve any problems.


Uc small logo.gif Ric