.htaccess to plik konfiguracyjny serwera Apache, który pozwala zmieniać jego zachowanie dla konkretnego katalogu bez edycji głównej konfiguracji. Używa się go m.in. do przekierowań, nagłówków i reguł dostępu.
Do czego służy?
- przekierowania 301 i przepisywanie adresów (mod_rewrite),
- wymuszanie HTTPS,
- nagłówki bezpieczeństwa i cache,
- blokowanie dostępu do plików i katalogów.
RewriteEngine On
RewriteCond %{HTTPS} off
RewriteRule ^ https://%{HTTP_HOST}%{REQUEST_URI} [R=301,L]
Na co uważać?
Kolejność reguł ma znaczenie, a błąd składni zwykle kończy się błędem 500 całej witryny. Przed zmianą zrób kopię pliku. Serwery Nginx nie czytają .htaccess.
Typowe zastosowania .htaccess
Plik służy do przekierowań (np. HTTP na HTTPS, www na bez www), zasad przepisywania adresów mod_rewrite, własnych stron błędów, ustawiania nagłówków cache i bezpieczeństwa oraz blokowania dostępu do wybranych plików. Działa na serwerach Apache i kompatybilnych. Błąd w pliku potrafi zablokować całą stronę błędem 500, więc przed edycją wykonaj kopię. Na serwerze Nginx ten plik jest ignorowany, a odpowiednikiem jest konfiguracja serwera.
Reguły są wykonywane w kolejności, dlatego bardziej szczegółowe wpisuj przed ogólnymi.
Plik jest ukryty, bo jego nazwa zaczyna się od kropki.
Dlaczego po zmianie .htaccess strona zwraca błąd 500?
Najczęściej przyczyną jest literówka, nieobsługiwana dyrektywa lub pętla przekierowań. Szczegóły znajdziesz w logu błędów serwera.
Zobacz w praktyce
Plik .htaccess bez tajemnic – przydatne reguły na przyspieszenie i porządek na serwerze
Błąd 500 (Internal Server Error) - co oznacza i jak go naprawić?
Błąd 403 (Forbidden) - co oznacza i jak go naprawić?