.htaccess je preprosta besedilna konfiguracijska datoteka, s katero lahko delovanje spletnega strežnika Apache spreminjaš po imenikih, brez dostopa do osrednjih nastavitev strežnika. Spletni strežnik jo prebere ob vsaki zahtevi, zato sprememba velja takoj, ponovni zagon ni potreben.

Kje deluje?

Na naših paketih spletnega gostovanja teče spletni strežnik Apache, tudi na gostovanju cPanel pa je mogoče uporabljati pravila .htaccess. Na statičnem gostovanju pa datoteke streže Nginx, ki datoteke .htaccess ne bere, tam so pravila v njej brez učinka.

Datoteka v korenskem imeniku spletne strani (ciljnem imeniku domene) velja za celotno spletno stran, postavljena v podimenik pa le za ta imenik in tiste pod njim. Datoteka .htaccess podimenika lahko prepiše pravila višje.

Za kaj jo lahko uporabiš?

• Preusmeritev: preusmeritev starih naslovov na nove, https:// namesto http://, z naslova brez www na naslov z www ali obratno.
• Prepis URL: WordPress in veliko drugih sistemov za upravljanje vsebin s pravili mod_rewrite ustvarijo „lepe” naslove brez parametrov.
• Omejitev dostopa: zaščita imenika z geslom, blokiranje naslovov IP, prepoved določenih vrst datotek.
• Lastne strani z napakami: na primer prikaz lastne strani 404.
• Predpomnjenje in stiskanje: nastavitev glav predpomnjenja, poslanih brskalniku, kar pospeši nalaganje strani za povratne obiskovalce.

Nekaj pogostih primerov

Trajna (301) preusmeritev stare strani:

Redirect 301 /regi-oldal.html /uj-oldal/

Izklop seznama imenika, da vsebina mape brez datoteke index ne bo pregledljiva:

Options -Indexes

Lastna stran z napako 404:

ErrorDocument 404 /404.html

Kako jo urejaš?

1. Poveži se z gostovanjem prek FTP ali odpri upravitelja datotek upraviteljskega vmesnika.
2. Ker se ime datoteke začne s piko, jo veliko programov obravnava kot skrito datoteko: vklopi prikaz skritih datotek.
3. Pred spremembo shrani obstoječo datoteko, da jo lahko ob napaki obnoviš.
4. Datoteko shrani z navadnim urejevalnikom besedil, s kodiranjem UTF-8; njeno ime naj bo natanko .htaccess, brez končnice .txt.
5. Po shranjevanju odpri spletno stran in preizkusi tudi spremenjene naslove.

Pogoste napake

• 500 Internal Server Error: zaradi zatipkanega ali na strežniku nedovoljenega ukaza postane vsa stran nedosegljiva. Obnovi shranjeno datoteko ali izbriši nazadnje vpisane vrstice. Pri WordPressu pomaga tudi ponastavitev datoteke .htaccess na privzeto stanje.
• Nastavitve PHP: vrstice php_value in php_flag ob PHP-FPM povzročijo napako. Parametre PHP nastavi v datoteki .user.ini.
• Zanka preusmeritev: če dve pravili preusmerjata drugo na drugo (ali se nastavitev Cloudflare in vsiljevanje HTTPS spopadeta), brskalnik vrne napako „preveč preusmeritev”.
• Prepisan blok WordPress: del med # BEGIN WordPress in # END WordPress upravlja WordPress sam; svoja pravila piši zunaj tega bloka, pred njim.

Vzorce preusmeritev najdeš na našem blogu: Preusmeritev v htaccess: praktični vodnik za pravilno nastavitev.