487
edits
Htaccess: Site error documents: Difference between revisions
Htaccess: Site error documents (view source)
Revision as of 13:38, 9 September 2011
, 9 September 2011Punctuation and grammatical changes; some clarification.
(New page: <span id="top"></span> <div style="padding:0;margin:0; border-bottom:3px inset #000000"> {| | MPG UniCenter || .htaccess: [[Htaccess: Introduction | Introduc...) |
(Punctuation and grammatical changes; some clarification.) |
||
| Line 22: | Line 22: | ||
Apache provides some bland error documents however you are not restricted to using these you can provide your own and match them to your sites look. | Apache provides some bland error documents however you are not restricted to using these you can provide your own and match them to your sites look. | ||
== | == What errors produce what == | ||
The following | The following is a list of the Apache error numbers and what they relate to: | ||
{|cellpadding="2" cellspacing:4px style="font-size:11px" | {|cellpadding="2" cellspacing:4px style="font-size:11px" | ||
| Line 33: | Line 33: | ||
|202 Accepted||style="background:#f0f0f0"|401 Authorization Required||501 Not Implemented | |202 Accepted||style="background:#f0f0f0"|401 Authorization Required||501 Not Implemented | ||
|- | |- | ||
|203 Non- | |203 Non-Authoritative Information||style="background:#f0f0f0"|403 Forbidden||502 Bad Gateway | ||
|- | |- | ||
|204 No Content||style="background:#f0f0f0"|404 Not Found||503 Service Unavailable | |204 No Content||style="background:#f0f0f0"|404 Not Found||503 Service Unavailable | ||
| Line 60: | Line 60: | ||
|} | |} | ||
'''''Note'':''' There is no need to create error pages for all the above | '''''Note'':''' There is no need to create error pages for all the above. The following are worth considering: 401, 403, 404 and 500 | ||
== How to create customised error documents == | == How to create customised error documents == | ||
Create a new folder in your root folder (www) and name it '''errors'''. This folder contains all the error pages you wish to display. For example '''not_found.html''' | Create a new folder in your root folder (www) and name it '''errors'''. This folder contains all the error pages you wish to display. For example, '''not_found.html''' will be displayed when a page cannot be found on your web site. | ||
Now open the root htaccess file (the one in your root folder www) and add the following line: | Now open the root .htaccess file (the one in your root folder www) and add the following line: | ||
'''ErrorDocument 404 /errors/not_found.html''' | '''ErrorDocument 404 /errors/not_found.html''' | ||
Save the file. The command '''ErrorDocument 404''' will forward a user to ''' | Save the file. The command '''ErrorDocument 404''' will forward a user to '''<root folder>/errors/not_found.html''' file when ever Apache produces the error 404. | ||
'''''Note 1'':''' The files and folder can be named anything you like.<br> | '''''Note 1'':''' The files and folder can be named anything you like.<br> | ||
'''''Note 2'':''' You can use a full URL (as oppose to a virtual path) to your error file for example: <nowiki>http://yoursite.com/errors/not_found.html</nowiki> | '''''Note 2'':''' You can use a full URL (as oppose to a virtual path) to your error file; for example: <nowiki>http://yoursite.com/errors/not_found.html</nowiki> | ||
If you create error pages for the above your htaccess file will look similar to this when using virtual paths: | If you create error pages for the above, your .htaccess file will look similar to this when using virtual paths: | ||
:* ErrorDocument 401 /errors/ | :* ErrorDocument 401 /errors/auth_required.html | ||
:* ErrorDocument 403 /errors/forbidden.html | :* ErrorDocument 403 /errors/forbidden.html | ||
:* ErrorDocument 404 /errors/not_found.html | :* ErrorDocument 404 /errors/not_found.html | ||
| Line 84: | Line 83: | ||
Or look like similar to this if when using full URL paths: | Or look like similar to this if when using full URL paths: | ||
:* ErrorDocument 401 <nowiki>http://yoursite.com/errors/ | :* ErrorDocument 401 <nowiki>http://yoursite.com/errors/auth_required.html</nowiki> | ||
:* ErrorDocument 403 <nowiki>http://yoursite.com/errors/forbidden.html</nowiki> | :* ErrorDocument 403 <nowiki>http://yoursite.com/errors/forbidden.html</nowiki> | ||
:* ErrorDocument 404<nowiki> http://yoursite.com/errors/not_found.html</nowiki> | :* ErrorDocument 404<nowiki> http://yoursite.com/errors/not_found.html</nowiki> | ||
:* ErrorDocument 500 <nowiki>http://yoursite.com/errors/server_error.html</nowiki> | :* ErrorDocument 500 <nowiki>http://yoursite.com/errors/server_error.html</nowiki> | ||
== Example == | == Example == | ||
The following shows a little more detail | The following shows a little more detail. First create the error page to be displayed: | ||
{| | {| | ||
| Line 108: | Line 107: | ||
<title>Not found</title> | <title>Not found</title> | ||
<body> | <body> | ||
<p>Example of a not found page</p> | <p>Example of a <b>not found</b> page</p> | ||
</body> | </body> | ||
</html> | </html> | ||
| Line 132: | Line 131: | ||
Deny from all | Deny from all | ||
Allow from 127.0.0.1 | Allow from 127.0.0.1 | ||
Allow from ::1 | |||
# To allow execution of cgi scripts in this directory uncomment next two lines. | # To allow execution of cgi scripts in this directory, uncomment next two lines. | ||
AddHandler cgi-script .pl .cgi | AddHandler cgi-script .pl .cgi | ||
| Line 152: | Line 152: | ||
=== Testing === | === Testing === | ||
:# Run the server using | :# Run the server using Start.exe | ||
:# In the browser address bar type '''<nowiki>http:/localhost/fred.html</nowiki>''' or some other file that does not exist. | :# In the browser address bar, type '''<nowiki>http:/localhost/fred.html</nowiki>''' or some other file that does not exist. | ||
:# Apache will generate the error code 404 and redirect to your not_found.html page | :# Apache will generate the error code 404 and redirect to your not_found.html page | ||
Experiment with the ErrorDocument command and create a few pages. | Experiment with the ErrorDocument command and create a few pages. | ||
---- | ---- | ||
[[Category: Support]] | [[Category: Support]] | ||
[[Category: Troubleshooting ]] | [[Category: Troubleshooting ]] | ||
[[Category: Development]] | [[Category: Development]] | ||