.htaccess on asetustiedosto, jonka avulla Apache-verkkopalvelin saadaan toimimaan sivustollasi tietyllä tavalla. Yleisin käyttötarkoitus on uudelleenohjaus: vierailija, joka avaa vanhan osoitteen, ohjataan automaattisesti uuteen osoitteeseen.
Tämä ohje koskee Plesk-hallintapaneelissa isännöityjä sivustoja. Jos webhotellisi hallintapaneeli on cPanel, tämä ohje ei koske sinua.
Ennen kuin aloitat
Tarvitset Domainkeskuksen webhotellipalvelun, jonka hallintapaneeli on Plesk.
Tiedät, mihin osoitteeseen haluat ohjata vierailijat (esimerkiksi https://www.esimerkki.fi/).
Vinkki: Virheellinen rivi .htaccess-tiedostossa voi estää koko sivuston toiminnan. Kopioi nykyisen tiedoston sisältö talteen ennen muutoksia, jotta voit palauttaa sen.
Ohjeet vaihe vaiheelta
Kirjaudu hallintapaneeliin osoitteessa login.domainkeskus.com/hosting. Syötä verkkotunnus, jonka hallintaan haluat kirjautua, ja syötä sen jälkeen Pleskin tunnukset. Tarkemmat ohjeet: Kirjautuminen hallintapaneeliin.
Avaa sen verkkotunnuksen hallintanäkymä, jonka sivustoa muokkaat, ja valitse Tiedostonhallinta.
Avaa sivuston juurikansio. Useimmissa tapauksissa se on httpdocs. Jos olet määrittänyt sivustolle toisen kotikansion, käytä sitä.
Tarkista, onko kansiossa jo tiedosto nimeltä .htaccess. Jos on, siirry vaiheeseen 7.
Jos tiedostoa ei ole, valitse plus-merkki ja sen jälkeen Luo tiedosto.
Kirjoita Tiedoston nimi -kenttään .htaccess (alkaa pisteellä, ei tiedostopäätettä) ja valitse OK.
Avaa .htaccess-tiedosto klikkaamalla sen nimeä. Tiedosto avautuu koodieditoriin.
Kirjoita tai liitä koodieditoriin haluamasi rivit, esimerkiksi jokin alla olevista uudelleenohjauksista.
Tallenna muutokset valitsemalla Tallenna (tallentaa ja sulkee editorin) tai Tallenna ja jatka (tallentaa ja pitää editorin auki).
Avaa sivusto selaimessa ja testaa muutos. Jos selain näyttää vanhan tuloksen, kokeile yksityistä selausikkunaa.
Lisätietoja vaiheista
Uudelleenohjaus Redirect-komennolla (vaihe 8)
Uudelleenohjausrivi muodostuu käskystä Redirect, valinnaisesta tilakoodista, osoitteesta josta ohjataan ja osoitteesta johon ohjataan. Osoite, josta ohjataan, alkaa aina kauttaviivalla. Koko verkkotunnuksen ohjaamiseen riittää pelkkä kauttaviiva.
Koko verkkotunnuksen ohjaus toiseen osoitteeseen:
Redirect 301 / https://www.esimerkkiosoite.fi/
Yksittäisen sivun ohjaus:
Redirect 301 /vanhasivu https://www.esimerkkiosoite.fi/uusisivu
Sama voidaan kirjoittaa myös muodossa Redirect permanent /vanhasivu https://www.esimerkkiosoite.fi/uusisivu
Tilakoodi: 301 vai 302
Jos et kirjoita tilakoodia lainkaan, Apache tekee väliaikaisen (302) uudelleenohjauksen. Kirjoita siksi 301 aina, kun muutos on pysyvä, esimerkiksi kun sivusto on muuttanut uuteen verkkotunnukseen. Hakukoneille 301 kertoo, että sisältö on siirtynyt pysyvästi. Käytä 302:ta (tai sanaa temp) vain väliaikaisiin ohjauksiin.
Mitä Redirect tekee polulle ja lomakkeille
Kun ohjaat koko verkkotunnuksen, Apache lisää pyydetyn polun ja mahdolliset hakuparametrit uuden osoitteen perään. Esimerkiksi vanhan sivuston osoite /palvelut/hinnasto ohjautuu osoitteeseen https://www.esimerkkiosoite.fi/palvelut/hinnasto. Uudella sivustolla pitää siis olla samat polut, tai sinun pitää ohjata yksittäiset sivut erikseen. Huomaa lisäksi, että lomakkeiden POST-tiedot hylätään uudelleenohjauksessa. Lisäksi vain kokonaiset polun osat täsmäävät: sääntö /palvelu ei täsmää osoitteeseen /palvelutarjous.
Rivien järjestys
Jos tiedostossa on useita Redirect-rivejä, Apache käy ne läpi siinä järjestyksessä, jossa ne on kirjoitettu, ja ensimmäinen täsmäävä rivi voittaa. Kirjoita siksi tarkimmat rivit (esimerkiksi /vanhasivu) ennen yleisiä rivejä (esimerkiksi /). Muuten yleinen rivi vie kaiken liikenteen ensin.
HTTP-osoitteen ohjaus HTTPS-osoitteeseen
Plesk ohjaa HTTP-osoitteen HTTPS-osoitteeseen oletuksena pysyvällä 301-uudelleenohjauksella, kun sivustolla on SSL/TLS-tuki käytössä. Asetus on verkkotunnuksen isännöintiasetuksissa nimellä Ohjaa vierailijat uudelleen HTTP:stä HTTPS:ään SEO-ystävällisen 301 uudelleenohjauksen avulla.
www-osoite tai ilman www:tä
Jos haluat, että sivusto aukeaa aina joko muodossa www.esimerkki.fi tai esimerkki.fi, Plesk tarjoaa tähän oman asetuksen: isännöintiasetuksista löytyy kohta Ensisijainen toimialue.
Miksi .htaccess ei toimi
Tiedosto on väärässä kansiossa. .htaccess vaikuttaa kansioon, jossa se on, ja sen alakansioihin.
Tiedoston nimi on väärin. Nimen pitää olla täsmälleen .htaccess
Vianmääritys ja usein kysytyt kysymykset
Sivusto näyttää virheen 500 (Internal Server Error) muutoksen jälkeen
.htaccess-tiedostossa on todennäköisesti kirjoitusvirhe tai käsky, jota palvelin ei salli. Avaa tiedosto uudelleen ja poista tai korjaa viimeksi lisäämäsi rivi. Tarkempi syy näkyy sivuston Apache-virhelokissa, josta palvelin kertoo esimerkiksi, että käsky ei ole sallittu tässä tai että syntaksi on virheellinen. Lokit löytyvät Pleskistä verkkotunnuksen lokinäkymästä.
Uudelleenohjaus ei tee mitään
Tarkista ensin, että tiedosto on juurikansiossa (yleensä httpdocs) ja että sen nimi on täsmälleen .htaccess. Kokeile yksityistä selausikkunaa, koska selain voi näyttää vanhan tuloksen muististaan.
Uudelleenohjaus jää silmukkaan
Selain ilmoittaa, että sivu ohjaa liian monta kertaa. Syynä on yleensä se, että kohdeosoite täsmää samaan sääntöön. Esimerkiksi rivi Redirect 301 / https://esimerkki.fi/ aiheuttaa silmukan, jos se on samalla verkkotunnuksella, johon ohjataan. Poista rivi ja varmista, että kohde on eri verkkotunnus tai että sääntö ei kata kohdeosoitetta.
En löydä .htaccess-tiedostoa Tiedostonhallinnasta
Tiedosto ei ole välttämättä vielä olemassa. Luo se vaiheiden 5 ja 6 mukaan.
Luo tiedosto -valinta tai Tiedostonhallinta puuttuu
Palveluntarjoaja päättää, mitkä toiminnot ovat käytössä paketissasi. Ota yhteyttä asiakaspalveluun.




