Generator przekierowań .htaccess

Generator przekierowań w .htaccess

Przekierowania przenoszą użytkowników i wyszukiwarki ze starych adresów na nowe. Dobrze ustawione chronią pozycję strony i unikają błędów 404.

301 czy 302?

Dopasowanie dokładne i prefiks

Reguła dokładna przenosi jeden adres. Wariant prefiksowy (RedirectMatch) obsługuje cały katalog — np. wszystkie podstrony /stary/ na /nowy/, zachowując resztę ścieżki.

Przykład

Redirect 301 /stara-strona https://example.com/nowa-strona

Dla katalogu: RedirectMatch 301 ^/blog/(.*)$ https://example.com/artykuly/$1.

Jak działa generator przekierowań .htaccess

Narzędzie zamienia trzy dane wejściowe — adres źródłowy, adres docelowy i kod odpowiedzi — na gotową regułę do pliku .htaccess. Serwer Apache czyta ten plik przy każdym żądaniu i porównuje ścieżkę z wzorcami od góry do dołu. Pierwsza pasująca reguła przejmuje żądanie, dlatego kolejność wpisów jest równie ważna jak ich treść.

Dla pojedynczego adresu powstaje dyrektywa z mod_alias, na przykład Redirect 301 /stara-strona https://example.com/nowa-strona. Dla całego katalogu potrzebny jest RedirectMatch z wyrażeniem regularnym i grupą przechwytującą, na przykład ^/blog/(.*)$ — nawias zbiera resztę ścieżki, a $1 wstawia ją do adresu docelowego. Bez grupy wszystkie podstrony trafiłyby na jeden wspólny adres, co dla wyszukiwarek jest błędem.

Gdy hosting nie ma mod_alias, generator przygotowuje wariant na mod_rewrite: RewriteEngine On oraz RewriteRule ^stara-strona/?$ https://example.com/nowa-strona [R=301,L]. Flaga R ustala kod odpowiedzi, a L kończy przetwarzanie dalszych reguł. Kod 301 oznacza przeniesienie trwałe, 302 tymczasowe — przeglądarka zapamiętuje 301 na długo, więc pomyłka w tym miejscu jest kosztowna i trudna do szybkiego cofnięcia.

Przykład krok po kroku: cztery adresy jedną regułą

1. Stan wyjściowy: w katalogu /blog/ masz cztery adresy — /blog/, /blog/poradnik, /blog/cena i /blog/kontakt. Nowa struktura to /artykuly/ z identycznymi końcówkami.
2. W narzędziu wpisujesz adres źródłowy /blog/, adres docelowy https://example.com/artykuly/ oraz kod 301.
3. Generator rozpoznaje, że źródłem jest katalog, i tworzy regułę prefiksową: RedirectMatch 301 ^/blog/(.*)$ https://example.com/artykuly/$1
4. Test pierwszego adresu: żądanie /blog/poradnik pasuje do wzorca, w grupie $1 ląduje tekst poradnik, wynik to https://example.com/artykuly/poradnik. Obsłużony 1 z 4 adresów.
5. Test drugiego: /blog/cena daje https://example.com/artykuly/cena. Do sprawdzenia zostają 2 adresy — /blog/ i /blog/kontakt — oba pasują do tego samego wzorca.
6. Bilans: 4 stare adresy obsłużone 1 regułą, czyli 0 dodatkowych wpisów i 1 kod odpowiedzi (301) dla całej grupy.

Tabela referencyjna: co wpisujesz i co dostajesz

Jak używać generatora w praktyce

• Wklejaj reguły pojedynczo i testuj — najpierw dodaj jeden wpis, sprawdź w narzędziu deweloperskim przeglądarki kod odpowiedzi i adres docelowy, dopiero potem wstawiaj kolejne. Błąd w pierwszej regule potrafi zamaskować działanie wszystkich następnych.
• Pilnuj kolejności wpisów — reguły bardziej szczegółowe umieszczaj nad ogólnymi. Szeroki wzorzec katalogowy postawiony wyżej przechwyci żądania, które miały trafić do wyjątku opisanego niżej.
• Wdrażaj przez 302, kończ na 301 — ustaw czasowo kod 302, sprawdź na kilku adresach, że nic nie ginie, a potem zmień na 301. Trwałe przekierowanie zapisuje się w przeglądarkach i robotach, więc poprawianie go po fakcie bywa uciążliwe.
• Sprawdź, czy nie tworzysz pętli — adres źródłowy i docelowy nie mogą wskazywać na siebie ani dwóch adresów na siebie nawzajem. Pętla kończy się błędem w przeglądarce i zablokowaniem całej ścieżki.
• Opisz wpisy komentarzem — linia zaczynająca się od znaku # z datą i powodem przekierowania oszczędza czas przy kolejnej zmianie struktury adresów, zwłaszcza gdy plik prowadzi kilka osób.

Ograniczenia narzędzia

• Nie sprawdza, czy adres docelowy istnieje — generator zwraca tylko regułę i nie wysyła żadnego żądania. Jeśli po stronie celu nie ma strony, użytkownik zobaczy 404 mimo poprawnie działającego przekierowania.
• Nie zna konfiguracji serwera — o tym, czy działa mod_alias, czy mod_rewrite, decyduje hosting. Narzędzie podaje oba warianty, ale nie wykryje, który moduł jest włączony ani czy przekierowanie w ogóle zostanie wykonane.
• Nie wykrywa konfliktów z istniejącym .htaccess — jeśli w pliku są już reguły, dyrektywa RewriteBase albo inne przekierowania, wklejony blok może zmienić ich działanie lub zostać przez nie przechwycony.
• Nie obsługuje logiki warunkowej — przekierowania zależne od języka przeglądarki, geolokalizacji, metody POST czy konkretnych parametrów zapytania wymagają ręcznego dopisania warunków, których prosty generator nie tworzy.

Najczęstsze pytania