Logo David Burdelak
Słownik · Web development

Co to jest .htaccess?

Ostatnia aktualizacja:

.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

Powiązane pojęcia

Wszystkie hasła z kategorii Web development