Door aan­ge­pas­te Apache-fout­pa­gi­na’s te maken, kunt u onder andere uw ontwerp en huisstijl op uw hele website zichtbaar maken. We laten u zien hoe u dit kunt doen.

Waarom zou je een aan­ge­pas­te fout­pa­gi­na moeten hebben?

Niemand wil HTTP- fouten op zijn webserver. Dit kan echter af en toe voorkomen, af­han­ke­lijk van de ser­ver­be­las­ting, in­ter­net­ver­bin­ding of ge­brui­kers­in­voer. De Apache-webserver biedt een stan­daardset generieke fout­pa­gi­na’s voor fout 404, HTTP-fout 500 en andere veel­voor­ko­men­de fouten.

Door aan­ge­pas­te fout­pa­gi­na’s te con­fi­gu­re­ren, kunt u echter:

  • Zet uw branding voort op deze pagina’s
  • Integreer hun ontwerp in de look en feel van uw website
  • Leid verloren bezoekers naar hun beoogde be­stem­ming
  • Zorg voor fout­pa­gi­na’s in andere talen dan het Engels

Vereisten

  • Cloud­ser­ver onder Linux (CentOS Stream 9 of Ubuntu 24.04)
  • Apache is ge­ïn­stal­leerd en actief

Hoe maak je een aan­ge­pas­te fout­pa­gi­na aan?

Eerst moet u de aan­ge­pas­te fout­pa­gi­na maken. Voor test­doel­ein­den maken we een voor­beeld­fout­pa­gi­na om 404-fouten af te handelen.

Gebruik SSH om ver­bin­ding te maken met uw server en ga naar de do­cu­men­troot van uw website (vaak /var/www/html/). Maak een nieuwe pagina met de naam my-404.html met het commando:

sudo nano my-404.html
bash

Zet het volgende in dit bestand:

<html>
<head>
<title>My Custom 404 Error Page</title>
</head>
<body>
<p>Whoops, page not found! Sorry about that.</p>
</body>
</html>

Sla het bestand op en sluit Nano af met de toets­com­bi­na­ties [Ctrl] + [O] en [Ctrl] + [X]. U kunt het bestand nu bekijken door naar http://example.com/my-404.html te gaan om te con­tro­le­ren of het correct wordt weer­ge­ge­ven.

Hoe maak je een aan­ge­pas­te fout­pa­gi­na in Apache

Nu moet u uw Apache-webserver zo con­fi­gu­re­ren dat deze ook de fout­pa­gi­na gebruikt die u zojuist hebt gemaakt. Voeg hiervoor een Er­ror­Do­cu­ment-richtlijn toe. De syntaxis voor deze richtlijn is:

ErrorDocument 404 [path to file]

Als u deze fout­pa­gi­na globaal wilt gebruiken, moet de richtlijn in het hoofd­con­fi­gu­ra­tie­be­stand van Apache staan. Als de pagina alleen voor een virtuele host moet worden gebruikt (bij­voor­beeld als uw website in meerdere talen be­schik­baar is), moet deze in een VirtualHost staan. In dit gedeelte be­han­de­len we voor­na­me­lijk de globale con­fi­gu­ra­tie.

Volgens de gangbare praktijk is dit Apache-con­fi­gu­ra­tie­be­stand meestal:

  • CentOS Stream 9 /etc/httpd/conf/httpd.conf
  • Ubuntu 24.04 /etc/apache2/apache2.conf
Opmerking

De locatie en be­stands­naam van het Apache-con­fi­gu­ra­tie­be­stand van een site kan variëren, af­han­ke­lijk van hoe u of uw ser­ver­be­heer­der de hosting heeft ingesteld.

Bewerk dit bestand met een editor naar keuze, bij­voor­beeld met het commando:

  • CentOS Stream 9 sudo nano /etc/httpd/conf/httpd.conf
  • Ubuntu 24.04 sudo nano /etc/apache2/apache2.conf

Voeg het Er­ror­Do­cu­ment op een geschikte plaats in. Bij­voor­beeld:

ErrorDocument 404 /my-404.html

Als u dit alleen voor een virtuele host wilt doen, moet u door het bij­be­ho­ren­de con­fi­gu­ra­tie­be­stand scrollen totdat u het VirtualHost op­dracht­blok vindt. Zorg ervoor dat de richtlijn buiten de directory-op­dracht­blok­ken wordt geplaatst. Bij­voor­beeld:

<VirtualHost *:80>
ServerName example.com
ErrorDocument 404 /my-404.html
    <Directory "/var/www/example.com/html">
    AllowOverride All
    </Directory>
</VirtualHost>

Sla het bestand op en sluit het af, start ver­vol­gens Apache opnieuw op om de wij­zi­gin­gen door te voeren:

  • CentOS Stream 9 sudo systemctl restart httpd
  • Ubuntu 24.04 sudo systemctl restart apache2

Test ten slotte uw fout­do­cu­ment door een ongeldige URL voor uw website in te voeren. U wordt dan door­ge­stuurd naar uw nieuwe aan­ge­pas­te 404-pagina.

Andere HTTP-foutcodes

De meest voor­ko­men­de aan­ge­pas­te fout­mel­ding is de 404-fout­mel­ding, maar u kunt ook aan­ge­pas­te fout­mel­din­gen maken voor andere HTTP-fout­mel­din­gen. Met Apache kunt u uw eigen fout­pa­gi­na’s con­fi­gu­re­ren voor alle 4xx- en 5xx-foutcodes. Een overzicht van de be­lang­rijk­ste HTTP-sta­tus­co­des vindt u in een ander artikel van ons. Een volledige lijst met foutcodes vindt u op Wikipedia.

Ga naar hoofdmenu