Redirect-regels Generator

Werking van de Redirect-regels Generator

Bij het migreren van een website, het herstructureren van URL-structuren of het opruimen van verouderde inhoud is het correct doorverwijzen van bezoekers en zoekmachines essentieel [Source 2]. Deze tool verwerkt een lijst met oude webadressen en de bijbehorende nieuwe bestemmingen om direct de benodigde configuratiecode voor de webserver of het hostingplatform te genereren.

De invoer verloopt via een CSV-bestand waarin de koppelingen zijn vastgelegd. Na het selecteren van de gewenste statuscode (permanent of tijdelijk) en de doelomgeving (Nginx, Apache of Vercel), produceert de generator de exacte regels. Deze code kan direct worden gekopieerd of gedownload voor implementatie in de serverconfiguratie.

Privacy en gegevensverwerking

Bij het gebruik van deze generator blijven alle gegevens lokaal. Het CSV-bestand en de gegenereerde regels worden volledig binnen de browser van de gebruiker verwerkt. Er vindt geen upload van bestanden of gegevens plaats naar BroBroGo.

Vereisten voor het CSV-bestand

Om succesvol redirect-regels te genereren, moet het geïmporteerde CSV-bestand aan specifieke structuur- en formaateisen voldoen:

• Koprij: Het bestand moet beginnen met een header die de kolommen source en target (of destination) definieert. Als deze ontbreken, toont de tool de foutmelding: De koprij heeft de kolommen 'source' en 'target' (of 'destination') nodig.
• Bestandsgrootte: Het CSV-bestand moet kleiner zijn dan 5 MB [Source 2]. Bij overschrijding verschijnt de melding: Dit CSV-bestand is te groot. Kies een bestand kleiner dan {max}.
• Aantal koppelingen: De tool ondersteunt maximaal 2.000 koppelingen per sessie. Indien dit aantal wordt overschreden, geldt de foutmelding: Deze tool accepteert maximaal {max} koppelingen tegelijk.
• URL-lengte: Individuele URL's binnen het bestand mogen niet langer zijn dan 2.048 tekens. Bij overschrijding activeert de foutmelding: Een URL op rij {line} is langer dan 2.048 tekens.

Elke rij na de koprij moet zowel een bron als een bestemming bevatten. Als een van beide ontbreekt, geeft de generator de foutmelding: Rij {line} vereist zowel een bron als een bestemming. Daarnaast moet elke bron uniek zijn; dubbele bronpaden resulteren in de foutmelding: Rij {line} herhaalt het bronpad {source}. Elke bron mag slechts één keer voorkomen.

Syntaxregels en beperkingen voor URL's

De generator hanteert strikte regels voor de opmaak van de bron- en bestemmings-URL's om compatibiliteit met de gekozen serveromgeving te garanderen:

Bron-URL (Source)

De bron kan een volledige HTTP- of HTTPS-URL zijn, of een relatief pad dat begint met een /. Hostnamen in de bron-URL worden automatisch door de tool verwijderd.

De bron mag geen query-parameters (zoals ?id=123) of fragmenten (zoals #sectie) bevatten. Als deze wel aanwezig zijn, weigert de tool de regel met de foutmelding: Rij {line} bevat een query-parameter of fragment in de bron. Gebruik alleen het kale bronpad.

Wildcards of route-patronen (zoals * of reguliere expressies) zijn eveneens niet toegestaan. De tool accepteert uitsluitend exacte paden en toont bij afwijkingen de melding: Rij {line} gebruikt wildcard- of route-patroontekens. Deze generator accepteert alleen exacte bronpaden. Een ongeldige bron activeert de foutmelding: Rij {line} heeft een ongeldige bron. Gebruik een HTTP(S)-URL of een pad dat begint met /.

Bestemmings-URL (Destination / Target)

De bestemming kan een volledige HTTP- of HTTPS-URL zijn, of een root-relatief pad. Indien de bestemming niet aan deze opmaak voldoet, verschijnt de foutmelding: Rij {line} heeft een ongeldige bestemming. Gebruik een HTTP(S)-URL of een pad dat begint met /.

Ondersteunde serveromgevingen en statuscodes

De generator ondersteunt twee HTTP-statuscodes voor de redirects:

• 301 Permanent: Wordt gebruikt wanneer een pagina definitief is verhuisd. Dit is de standaardmethode om SEO-waarde (linkwaarde) over te dragen naar de nieuwe URL [Source 2].
• 302 Tijdelijk: Wordt gebruikt wanneer een pagina tijdelijk via een andere URL bereikbaar moet zijn, waarbij de indexering van de originele URL behouden blijft [Source 2].

De gegenereerde syntax verschilt per geselecteerde omgeving:

Nginx

Voor Nginx genereert de tool exacte match-regels waarbij de invoer hard wordt gekoppeld aan het specifieke bronpad. Dit voorkomt dat subpaden ongewenst worden meegestuurd naar de nieuwe bestemming.

Apache

Voor Apache-webservers worden de regels geformatteerd voor opname in het .htaccess-bestand. Ook hier zijn de regels verankerd aan het exacte bronpad om onbedoelde matches van achterliggende mappen te voorkomen.

Vercel

Vercel-configuraties worden gegenereerd in JSON-formaat. Omdat de standaard permanent parameter van Vercel resulteert in een HTTP 308 statuscode en de tijdelijke variant in een HTTP 307 statuscode, maakt deze generator expliciet gebruik van de statusCode parameter. Hierdoor wordt gegarandeerd dat de server daadwerkelijk met een exacte 301 of 302 statuscode antwoordt.

Statusmeldingen en foutafhandeling

Tijdens het proces doorloopt de tool verschillende statussen en voert strenge controles uit op de integriteit van het CSV-bestand:

• Gereed. Importeer een CSV met bron- en doelkoppelingen.: De beginstatus van de tool.
• {name} staat klaar.: Getoond zodra er een bestand is geselecteerd.
• Lezen van {name}…: De tool leest de inhoud van het bestand in.
• CSV-rijen controleren in {name}…: De parser controleert de opbouw van de rijen. Als de parser vastloopt door foutieve aanhalingstekens of komma's, verschijnt de foutmelding: Het CSV-bestand kon niet worden verwerkt rond rij {line}. Controleer de aanhalingstekens en komma's.
• Redirect-regels genereren uit {name}…: De serverregels worden opgebouwd op basis van de gekozen instellingen.
• {count} exacte {status} redirect-regel(s) gegenereerd.: Bevestiging van een succesvolle generatie.
• Regels gedownload.: Status na het exporteren van de regels naar een lokaal bestand.
• Bestand en regels gewist.: Status nadat de invoer en uitvoer zijn leeggemaakt via de knop Wissen.

Mocht het genereren door technische redenen mislukken of te lang duren, dan treden de volgende foutmeldingen in werking:

• Het genereren duurde te lang. Controleer het CSV-bestand en probeer het opnieuw.
• De regels konden niet worden gegenereerd. Controleer het CSV-bestand en probeer het opnieuw.

Veelgestelde vragen

Hoe moet ik het CSV-bestand opmaken?
Gebruik een koprij met de kolommen 'source' en 'target' (of 'destination'). Elke volgende rij kan een volledige HTTP- of HTTPS-bron-URL bevatten, of een pad dat begint met /, plus een volledige of relatieve bestemming.

Zijn de gegenereerde redirects exacte matches?
Ja. De uitvoer voor Nginx en Apache is gekoppeld aan het exacte bronpad, en Vercel ontvangt hetzelfde letterlijke pad. Een bron-hostnaam wordt verwijderd; bron-query-parameters, fragmenten en wildcard-patronen worden geweigerd omdat de drie omgevingen hier verschillend mee omgaan.

Waarom gebruikt de Vercel-uitvoer statusCode?
De permanente redirect van Vercel produceert een 308 en de tijdelijke een 307. Er wordt gebruikgemaakt van statusCode zodat je keuze exact op 301 of 302 blijft staan. Standaard Vercel-implementaties staan in totaal 2.048 routes toe, dus deze tool accepteert maximaal 2.000 koppelingen.