Generator pravil za preusmeritve

Delovanje generatorja pravil za preusmeritve

Pri selitvi spletnega mesta, spreminjanju strukture URL-jev ali čiščenju stare vsebine je treba zagotoviti, da obiskovalci in iskalniki ne naletijo na neobstoječe strani [Source 2]. Generator pravil za preusmeritve omogoča pretvorbo seznama izvornih in ciljnih naslovov v konfiguracijsko kodo, prilagojeno za specifična spletna okolja.

Postopek deluje tako, da v orodje uvozite datoteko CSV, ki vsebuje preslikave med starimi in novimi naslovi. Nato izberete vrsto preusmeritve (trajna ali začasna) in ciljno okolje spletnega strežnika ali platforme za gostovanje. Orodje nato samodejno ustvari ustrezne konfiguracijske vrstice, ki jih lahko kopirate ali prenesete za neposredno uporabo v svojem projektu.

Vhodni podatki in tehnične omejitve

Za uspešno generiranje pravil mora vhodna datoteka izpolnjevati naslednje tehnične pogoje:

• Oblika datoteke CSV: Datoteka mora vsebovati dva stolpca z glavo source in target (ali destination). Vsaka naslednja vrstica predstavlja eno preslikavo, ki vsebuje izvorni in ciljni URL.
• Format izvornega URL-ja: Izvor je lahko celoten HTTP ali HTTPS URL ali pa pot, ki se začne z znakom /.
• Format ciljnega URL-ja: Cilj je lahko celoten HTTP ali HTTPS URL ali pa relativna pot glede na korensko mapo.
• Omejitev velikosti datoteke: Velikost uvožene datoteke CSV mora biti pod 5 MB [Source 2].
• Število preslikav: Orodje podpira obdelavo do 2.000 preslikav hkrati.

Med nastavitvami lahko izberete statusno kodo preusmeritve:

• 301 Trajna (Permanent) (trajna preusmeritev)
• 302 Začasna (Temporary) (začasna preusmeritev)

Podprta so tri okolja za izvajanje preusmeritev: Nginx, Apache in Vercel.

Pravila obdelave in posebni primeri

Generator deluje po načelu natančnega ujemanja. To pomeni, da so generirana pravila za Nginx in Apache sidrana na natančno izvorno pot, medtem ko Vercel prejme enako dobesedno pot.

Pri obdelavi podatkov veljajo naslednja pravila:

• Izvorni gostitelji (hostnames) se iz vhodnih podatkov samodejno odstranijo.
• Izvorni poizvedbeni nizi (query strings), fragmenti (sidra z #) in vzorci z divjimi kartami (wildcards) niso dovoljeni in bodo zavrnjeni.
• Pri izbiri okolja Vercel se v izhodni kodi uporabi parameter statusCode. S tem se zagotovi ohranitev izbrane kode 301 ali 302, saj Vercelova privzeta nastavitev za trajne preusmeritve uporablja kodo 308, za začasne pa kodo 307.

Sintaksa preusmeritev za Nginx, Apache in Vercel

Vsako spletno okolje zahteva specifično sintakso za pravilno usmerjanje prometa.

Nginx

Nginx uporablja konfiguracijske direktive znotraj blokov strežnika. Generator ustvari pravila, ki natančno ujemajo izvorno pot in jo preusmerijo na cilj z ustrezno kodo 301 ali 302. Ker so pravila sidrana, se prepreči neželeno ujemanje delnih poti.

Apache

Za strežnike Apache se pravila zapišejo v datoteko .htaccess z uporabo modula mod_alias ali mod_rewrite. Generator ustvari natančne direktive, ki zagotavljajo pravilno interpretacijo poti brez prenosa dodatnih parametrov, če to ni eksplicitno določeno.

Vercel

Vercel konfigurira preusmeritve prek datoteke vercel.json. Ker platforma Vercel pri uporabi standardnih stikal za trajne in začasne preusmeritve vrača kodi 308 oziroma 307, generator v konfiguracijo zapiše parameter statusCode. To omogoča natančno uporabo kod 301 in 302.

Zasebnost in obdelava podatkov

Vsi procesi branja, razčlenjevanja in generiranja pravil se izvajajo lokalno v vašem spletnem brskalniku. Vaša datoteka CSV in generirana pravila ostanejo v vašem brskalniku. Nič se ne prenaša na BroBroGo.

Pogosta vprašanja

Kako naj bo oblikovana datoteka CSV?

Uporabite vrstico z glavo, ki vsebuje stolpca 'source' in 'target' (namesto target deluje tudi 'destination'). Vsaka naslednja vrstica lahko vsebuje celoten izvorno HTTP ali HTTPS URL ali pot, ki se začne z /, ter celoten ali relativni cilj.

Ali so generirane preusmeritve natančna ujemanja?

Da. Izpisa za Nginx in Apache sta vezana na natančno izvorno pot, Vercel pa prejme enako dobesedno pot. Izvorno ime gostitelja se odstrani; izvorni poizvedbeni nizi, fragmenti in vzorci z divjimi kartami (wildcards) so zavrnjeni, ker jih ta tri okolja obravnavajo različno.

Zakaj izhod za Vercel uporablja statusCode?

Vercelova trajna preusmeritev vrne kodo 308, začasna pa 307. Uporabljena je možnost statusCode, tako da vaša izbira ostane natančno 301 ali 302. Standardne namestitve na Vercelu omogočajo skupno 2.048 poti, zato to orodje sprejme do 2.000 preslikav.

Katere napake lahko preprečijo generiranje pravil?

Generiranje se lahko zaustavi, če datoteka CSV presega velikost 5 MB ali vsebuje več kot 2.000 preslikav. Napake se pojavijo tudi, če vrstica z glavo ne vsebuje zahtevanih stolpcev, če posamezna vrstica nima obeh vrednosti (vira in cilja), če vir vsebuje poizvedbene nize, fragmente ali nadomestne znake, ali če je kateri koli URL daljši od 2.048 znakov. Vsaka izvorna pot se lahko v datoteki pojavi le enkrat.