Generador de regles de redirecció

Funcionament del Generador de regles de redirecció

El Generador de regles de redirecció és una eina dissenyada per facilitar la creació de codi de redirecció específic per al vostre servidor web o plataforma d'allotjament. El procés s'inicia a partir d'una llista de correspondències que conté les adreces web d'origen que voleu redirigir i les noves adreces de destinació on han d'anar els usuaris.

Per utilitzar l'eina, heu de proporcionar aquesta llista mitjançant un fitxer en format CSV. A continuació, podeu triar si les redireccions han de ser permanents o temporals, i seleccionar l'entorn web de destinació on s'aplicaran les regles. Un cop processada la informació, l'eina mostra les regles generades en un espai de text des d'on les podeu copiar o baixar directament.

Requisits i format dels fitxers d'entrada

Perquè l'eina pugui processar correctament les dades, el fitxer d'entrada ha de complir uns requisits estructurals i de format molt concrets:

• Format del fitxer CSV: Ha de ser un fitxer CSV que contingui dues columnes a la capçalera anomenades exactament source i target (o bé destination). Cada fila posterior a la capçalera ha d'incloure una URL d'origen i una URL de destinació.
• Format de la URL d'origen: Es pot introduir com una URL completa amb protocol HTTP o HTTPS, o bé com una ruta relativa que comenci obligatòriament amb el caràcter /.
• Format de la URL de destinació: S'accepta tant una URL completa amb protocol HTTP o HTTPS com una ruta relativa a l'arrel.
• Límits de mida i capacitat: El fitxer CSV seleccionat ha de tenir una mida inferior a 5 MB. A més, l'eina admet un límit màxim de fins a 2.000 correspondències per processament.

Opcions de configuració: Codis d'estat i entorns

L'eina permet adaptar les regles generades segons les necessitats tècniques del vostre projecte mitjançant la selecció de paràmetres específics:

Codi d'estat

Podeu triar entre dues opcions de redirecció segons la naturalesa del canvi d'adreça:

• 301 Permanent: Indicat per a canvis definitius de localització de les pàgines.
• 302 Temporal: Indicat per a redireccions que només s'han d'aplicar durant un període de temps limitat.

Entorn

El generador és capaç de traduir les correspondències del CSV a la sintaxi exacta de tres entorns de servidor diferents:

• Nginx
• Apache
• Vercel

Regles de validació i gestió de casos especials

Durant el processament del fitxer CSV, l'eina aplica un conjunt estricte de validacions per garantir que les regles generades funcionin correctament i no generin errors al servidor:

• Coincidències exactes: Totes les redireccions generades es basen en coincidències exactes. En els entorns de Nginx i Apache, la sortida s'ancora a la ruta d'origen exacta, mentre que Vercel rep la mateixa ruta literal.
• Noms d'host d'origen: Els noms d'host que s'incloguin a les URL d'origen s'eliminen automàticament durant el processament.
• Elements exclosos: Es rebutgen completament les cadenes de consulta (query strings), els fragments i els patrons de tipus comodí (wildcards) a les URL d'origen.
• Particularitat de Vercel: Per a l'entorn de Vercel, la sortida utilitza el paràmetre statusCode per assegurar que es mantingui el codi d'estat 301 o 302 seleccionat. Això es fa així perquè els commutadors natius de Vercel per a redireccions permanents o temporals generen codis 308 i 307 respectivament.

Missatges d'estat i d'error de la interfície

L'eina es comunica amb l'usuari mitjançant missatges clars que descriuen l'estat del procés o els motius pels quals no s'ha pogut completar la generació de regles:

• Llest. Importeu un CSV de correspondències d'origen i destinació.: Missatge inicial que es mostra abans de pujar cap fitxer.
• {name} està llest.: S'activa un cop s'ha seleccionat correctament un fitxer.
• S'està llegint {name}…: Es mostra durant la lectura del fitxer CSV.
• S'estan comprovant les files del CSV a {name}…: Apareix mentre s'analitza l'estructura interna del fitxer.
• S'estan generant les regles de redirecció a partir de {name}…: S'activa durant el procés de creació de les regles.
• S'ha(n) generat {count} redirecció/ons exacta/es {status}.: Confirma l'èxit de l'operació i detalla el volum de regles creades.
• S'han baixat les regles.: Es mostra quan s'ha completat la descàrrega del fitxer de regles.
• S'ha netejat el fitxer i les regles.: Apareix en restablir l'eina a l'estat inicial.

En cas que es detectin problemes amb les dades d'entrada, es poden mostrar els següents missatges d'error:

• Primer trieu un fitxer CSV.
• Trieu un fitxer.csv.
• Aquest CSV és massa gran. Trieu un fitxer inferior a {max}.
• El CSV no conté correspondències de redirecció.
• No s'ha pogut analitzar el CSV a prop de la fila {line}. Comproveu-ne les cometes i les comes.
• La fila de capçalera necessita les columnes source i target (o destination).
• La fila {line} necessita tant un origen com una destinació.
• La fila {line} té un origen no vàlid. Utilitzeu una URL HTTP(S) o una ruta que comenci per /.
• La fila {line} inclou una cadena de consulta o un fragment a l'origen. Utilitzeu només la ruta d'origen.
• La fila {line} utilitza caràcters comodí o de patró de ruta. Aquest generador només accepta rutes d'origen exactes.
• La fila {line} té una destinació no vàlida. Utilitzeu una URL HTTP(S) o una ruta que comenci per /.
• Una URL de la fila {line} supera els 2.048 caràcters.
• La fila {line} repeteix la ruta d'origen {source}. Cada origen pot aparèixer una sola vegada.
• Aquesta eina admet fins a {max} correspondències alhora.
• La generació ha trigat massa. Comproveu el CSV i torneu-ho a provar.
• No s'han pogut generar les regles. Comproveu el CSV i torneu-ho a provar.

Casos d'ús habituals

La generació automatitzada de regles de redirecció és una tasca essencial en diversos escenaris de gestió web:

• Migració de llocs web: Quan es trasllada un lloc web complet a un nou domini o plataforma i cal assegurar que els usuaris arribin a les noves adreces equivalents.
• Reestructuració d'URL: En moments de reorganització de l'estructura de carpetes o de la jerarquia de continguts d'un lloc web existent.
• Neteja de contingut antic: Per redirigir de manera controlada aquelles pàgines obsoletes o eliminades cap a seccions noves o rellevants.
• Tasques d'administració web: Com a eina de suport per a administradors de sistemes o desenvolupadors que necessiten escriure codi de configuració de servidors de manera ràpida i sense errors manuals.

Privadesa i seguretat de les dades

Quan utilitzeu aquesta eina, el vostre fitxer CSV i les regles generades es queden completament al vostre navegador. No es puja absolutament cap dada ni fitxer als servidors de BroBroGo, garantint així la privadesa de la vostra informació de mapeig.

Preguntes més freqüents (FAQ)

Com he de formatar el fitxer CSV?

Utilitzeu una fila de capçalera amb les columnes "source" i "target" (o "destination"). Cada fila següent pot utilitzar una URL d'origen HTTP o HTTPS completa o una ruta que comenci per /, a més d'una destinació completa o relativa a l'arrel.

Les redireccions generades són coincidències exactes?

Sí. La sortida de Nginx i Apache s'ancora a la ruta d'origen exacta, i Vercel rep la mateixa ruta literal. Es descarta el nom d'host d'origen; es rebutgen les cadenes de consulta, fragments i patrons de tipus comodí d'origen perquè els tres entorns els gestionen de manera diferent.

Per què la sortida de Vercel utilitza statusCode?

El canvi permanent de Vercel produeix un 308 i el temporal un 307. S'utilitza statusCode perquè la vostra elecció es mantingui exactament en 301 o 302. Els desplegaments estàndard de Vercel permeten 2.048 rutes totals, de manera que aquesta eina accepta fins a 2.000 correspondències.