De documentroot is de basismap waaruit een webserver bestanden voor een website kan aanbieden. Deze term helpt wanneer je bestanden hebt laten plaatsen maar de website nog andere inhoud toont. Begin dan met de vraag welke map bij het bedoelde domein hoort.
Ga niet op basis van een herkenbare mapnaam bestanden verplaatsen. Vraag de beheerder om de koppeling te bevestigen en leg vast welke omgeving je probeert te bekijken.
Wat doet de webserver met die map?
De Apache-documentatie over URL-koppeling beschrijft DocumentRoot als basis voor de gebruikelijke vertaling van een aangevraagd pad naar een bestand. Apache kan per virtuele host een andere basis gebruiken. Dit is het concrete voorbeeld in dit artikel; laat bij andere serverproducten de overeenkomstige instelling door de beheerder aanwijzen.
De webserverEen webserver is het programma op een server dat verzoeken van bezoekers aanneemt en pagina's en bestanden terugstuurt. bepaalt hoe een aanvraag wordt afgehandeld. De documentroot is daar een onderdeel van. Apache beschrijft ook andere manieren van doorverwijzen en koppelen.
Daarom is het te sterk om uit één mapnaam af te leiden waar iedere URL vandaan komt. Vraag naar de route die bij jouw gemelde probleem hoort.
Waarom is het domein belangrijk?
Welke PHP-versie meldt jouw site?
Passieve check van headers, versie en de kop van de homepage. Geen login, geen scan.
Neem de volledige domeinnaamEen domeinnaam is het webadres waarmee bezoekers jouw website vinden, zoals jouwbedrijf.example. op in je vraag, inclusief het gebruikte subdomein. Vermeld ook of het gaat om de live website of een testomgevingEen stagingomgeving is een afgeschermde kopie van je website waarop je updates uitprobeert voordat ze live gaan.. Voor jou kunnen die op elkaar lijken, terwijl het onderzoek juist over de koppeling van een specifieke naam gaat.
Laat de beheerder terugmelden welke naam is gecontroleerd.
Een praktische melding is bijvoorbeeld dat een gewijzigde pagina op de testomgeving zichtbaar is, maar op het hoofddomein niet. Voeg de bekeken URL en de verwachte inhoud toe. Laat vervolgens onderzoeken welke map en welke verdere verwerking bij die aanvraag horen.
De waarneming is bruikbaar zonder dat je zelf al hoeft te bepalen welk configuratieonderdeel fout staat.
Hoe controleer je een publicatie?
Spreek bij een deployEen deployment is het moment waarop een nieuwe versie van je website live gaat en bezoekers hem zien. af welke zichtbare wijziging je na afloop controleert. Kies iets dat bij de bedoelde uitgave hoort, zoals een aangepaste kop of een nieuwe pagina. Vraag waar die uitgave is geplaatst en hoe het domein erop is aangesloten.
Bewaar die informatie met het resultaat van je controle.
Controleer niet alleen of de startpagina opent. Als de wijziging een specifieke pagina of afbeelding betreft, bekijk dan die URL. Meld exact wat je ziet en wat je verwacht.
Een werkende startpagina vertelt niet of het bestand of de route uit de opdracht daadwerkelijk wordt aangeboden. Het doel van de controle is de bedoelde uitgave herkennen.
Wat doe je bij onverwachte inhoud?
Laat eerst vaststellen dat je de juiste omgeving bekijkt. Vraag daarna om de mapkoppeling en de relevante routering te controleren. Verwijder geen oude mappen om te ontdekken welke in gebruik is.
Een ontbrekend bestand veroorzaken is geen geschikte manier om een onduidelijke serverinrichting te onderzoeken. Een beheerder kan de inrichting gericht beoordelen.
Geef ook door wanneer je de afwijking voor het eerst zag en of dezelfde URL eerder wel goed werkte. Die informatie helpt om het onderzoek te koppelen aan een concrete wijziging. Vraag na herstel welke oorzaak is vastgesteld.
Een algemene melding dat de website opnieuw is gepubliceerd verklaart nog niet waarom je eerder de verkeerde inhoud kreeg.
Welke overdracht is bruikbaar?
Bewaar het domein, de gecontroleerde URL, de relevante mapkoppeling en de herkende uitgave in een interne onderhoudsnotitie. Zet geen serverpaden of configuratiedetails op een publieke diagnosepagina. De eigenaar heeft vooral een bevestiging nodig dat de bedoelde inhoud via de bedoelde URL beschikbaar is.
Technische details kunnen bij de beheerder blijven.
Laat je je website verhuizen, neem de controle van deze koppeling op in de verhuisafspraak. Test na de verhuizing dezelfde pagina’s en gebruikershandelingen. Leg resterende afwijkingen afzonderlijk vast, zodat een juiste mapkoppeling niet wordt verward met bewijs dat alle onderdelen van de website volledig zijn gecontroleerd.
Veelgestelde vragen
Heet de documentroot altijd public_html?
Nee. Gebruik de map die voor jouw website is ingesteld. Een bekende mapnaam is geen bewijs dat de webserver die map gebruikt.
Is de documentroot hetzelfde als een domein?
Nee. Het domein is de naam waarmee je de website benadert. De documentroot is een map in de serverinrichting; laat de koppeling controleren.
Bewijst een juiste documentroot dat elke URL werkt?
Nee. Ook andere regels kunnen bepalen hoe een aanvraag wordt afgehandeld. Controleer de concrete pagina of handeling uit de oorspronkelijke melding.