Il "Generatore di Regole di Reindirizzamento" è uno strumento progettato per semplificare la migrazione di siti web, la ristrutturazione degli URL e la rimozione di vecchi contenuti. Il tool elabora un elenco di indirizzi di origine e le relative destinazioni per produrre il codice di configurazione specifico per il server web o la piattaforma di hosting selezionata.
Il processo di elaborazione avviene interamente all'interno del browser dell'utente: il file CSV e le regole generate rimangono nel Suo browser e nulla viene caricato su BroBroGo.
Funzionamento e requisiti del file CSV
Per utilizzare lo strumento, è necessario fornire un file in formato CSV che contenga le mappature degli URL. Il file deve rispettare requisiti strutturali precisi per poter essere elaborato correttamente:
- Dimensione massima: Il file CSV deve avere una dimensione inferiore a 5 MB.
- Limite di mappature: Lo strumento accetta fino a 2.000 mappature alla volta.
- Struttura delle colonne: La riga di intestazione richiede le colonne "source" e "target" (o "destination").
- Formato dell'origine (Source): Può essere un URL HTTP o HTTPS completo, oppure un percorso che inizia con
/. Gli hostname di origine vengono rimossi automaticamente durante l'elaborazione. Non è consentito inserire query string, frammenti (caratteri#) o pattern con caratteri jolly. - Formato della destinazione (Target/Destination): Può essere un URL HTTP o HTTPS completo, oppure un percorso relativo alla radice.
- Lunghezza degli URL: La lunghezza massima consentita per un singolo URL è di 2.048 caratteri.
Gestione dei codici di stato 301 e 302
La scelta del codice di stato corretto è fondamentale per la gestione del posizionamento nei motori di ricerca (SEO) e per indicare ai browser come gestire la cache dei reindirizzamenti:
- 301 Permanente: Indica che la risorsa si è trasferita in modo definitivo al nuovo indirizzo. I motori di ricerca trasferiscono il valore SEO accumulato dal vecchio URL a quello nuovo.
- 302 Temporaneo: Indica che lo spostamento è solo temporaneo. I motori di ricerca mantengono indicizzato l'URL di origine senza trasferire in modo definitivo l'autorità alla destinazione.
Sintassi e logica per Nginx, Apache e Vercel
I reindirizzamenti generati sono corrispondenze esatte. L'output per Nginx e Apache è ancorato al percorso esatto di origine, mentre Vercel riceve lo stesso percorso letterale. Ciascun ambiente richiede una sintassi specifica:
Nginx
Nginx utilizza direttive precise all'interno dei propri file di configurazione. Lo strumento genera regole ancorate per garantire che solo il percorso esatto specificato attivi il reindirizzamento, escludendo variazioni o estensioni del percorso non mappate.
Apache
Per i server Apache, le regole vengono formattate per essere inserite nel file .htaccess. Anche in questo caso, la sintassi applicata garantisce l'ancoraggio esatto del percorso di origine per evitare reindirizzamenti indesiderati su sotto-percorsi.
Vercel
La configurazione per Vercel viene generata in formato JSON. Nei deployment standard di Vercel, un reindirizzamento configurato come permanente produce un codice di stato 308, mentre uno temporaneo produce un 307. Per garantire che la scelta dell'utente rimanga esattamente 301 o 302, lo strumento utilizza esplicitamente la proprietà statusCode all'interno del file di configurazione.
Messaggi di stato e diagnostica degli errori
Durante il caricamento e l'elaborazione del file, l'interfaccia mostra messaggi di stato in tempo reale per descrivere l'operazione in corso:
- Pronto. Importi un file CSV di mappatura tra origine e destinazione. (Stato iniziale).
{name}è pronto. (Dopo la selezione del file).- Lettura di
{name}in corso…. - Verifica delle righe del CSV in
{name}in corso…. - Generazione delle regole di reindirizzamento da
{name}in corso…. - Generati
{count}reindirizzamenti esatti{status}.. - Regole scaricate..
- File e regole cancellati..
In caso di problemi con il file CSV o con i dati inseriti, lo strumento blocca la generazione e mostra uno dei seguenti messaggi di errore specifici:
Selezioni prima un file CSV.Scelga un file con estensione.csv.Questo file CSV è troppo grande. Scelga un file inferiore a {max}.Il file CSV non contiene mappature di reindirizzamento.Impossibile analizzare il file CSV nei pressi della riga {line}. Verifichi virgolette e virgole.La riga di intestazione richiede le colonne "source" e "target" (o "destination").La riga {line} richiede sia un'origine sia una destinazione.La riga {line} presenta un'origine non valida. Utilizzi un URL HTTP(S) o un percorso che inizia con /.La riga {line} include una query string o un frammento nell'origine. Utilizzi solo il percorso di origine.La riga {line} utilizza caratteri jolly o pattern di rotta. Questo generatore accetta solo percorsi di origine esatti.La riga {line} presenta una destinazione non valida. Utilizzi un URL HTTP(S) o un percorso che inizia con /.Un URL alla riga {line} supera i 2.048 caratteri.La riga {line} ripete il percorso di origine {source}. Ogni origine può apparire una sola volta.Questo strumento accetta fino a {max} mappature alla volta.La generazione ha richiesto troppo tempo. Verifichi il file CSV e riprovi.Impossibile generare le regole. Verifichi il file CSV e riprovi.
Domande frequenti (FAQ)
Come deve essere formattato il file CSV?
Utilizzi una riga di intestazione con le colonne "source" e "target" (o "destination"). Ciascuna riga successiva può contenere un URL di origine HTTP o HTTPS completo o un percorso che inizia con /, insieme a una destinazione completa o relativa alla radice.
I reindirizzamenti generati sono corrispondenze esatte?
Sì. L'output per Nginx e Apache è ancorato al percorso esatto di origine, e Vercel riceve lo stesso percorso letterale. L'hostname di origine viene rimosso; le query string, i frammenti e i pattern con caratteri jolly di origine vengono rifiutati poiché i tre ambienti li gestiscono in modo differente.
Perché l'output per Vercel utilizza statusCode?
Il reindirizzamento permanente di Vercel produce un codice 308, mentre quello temporaneo produce un 307. Viene utilizzato "statusCode" in modo che la Sua scelta rimanga esattamente 301 o 302. I deployment standard di Vercel consentono un massimo di 2.048 rotte totali, pertanto questo strumento accetta fino a 2.000 mappature.
Posso includere parametri di query o caratteri jolly nell'URL di origine?
No. Lo strumento accetta esclusivamente percorsi di origine esatti. Se una riga del file CSV contiene query string, frammenti o caratteri jolly (come asterischi o pattern di rotta), l'elaborazione si interromperà mostrando un errore specifico per la riga interessata.