AWWW-1st3.6-w12.tresc-1.0-Slajd11
Parametr ErrorDocument
Jeżeli obsługa żądania kończy się niepowodzeniem, serwer HTTP umieszcza w nagłówku odpowiedzi HTTP kod zwrotny błędu. Kod ten jest wykorzystywany przez program klienta HTTP do wyświetlenia stosownego komunikatu dla użytkownika końcowego. Serwer Apache daje jednak możliwość podmiany kodu błędu na kompletny poprawny dokument opisujący problem, który wystąpił. Wówczas program klienta HTTP potraktuje swoje żądanie jako obsłużone właściwie i wyświetli otrzymany dokument.
Do zastępowania standardowych kodów zwrotnych dokumentami opisowymi służy parametr ErrorDocument. Parametr ten jest dwuwartościowy. Pierwsza wartość to podmieniany kod zwrotny, a druga to nazwa pliku dokumentu lub wręcz treść dokumentu opisowego. W przykładzie na slajdzie dokonano dwóch podmian standardowych kodów zwrotnych:
- jeżeli obsługa żądania HTTP zakończy się kodem 404, wtedy klient HTTP otrzyma dokument tekstowy o treści "Przepraszamy, nie posiadamy dokumentu o takim URL",
- jeżeli obsługa żądania HTTP zakończy się kodem 401, wtedy klient HTTP otrzyma dokument HTML o nazwie "accessdenied.html" znajdujący się w katalogu "/messages".
