XAMPPin asennus ja käyttöönotto

XAMPP on erityisesti tarkoitettu helpottamaan web kehityksen omalla koneella, kun se sisältää tavallisimmat komponentit, joita siinä käytetään:

Apache: Web-palvelin
MySQL/MariaDB: tietokantojen hallintajärjestelmä
PHP: webohjelmointi kieli
XAMPP sisältää jotain muuta moduleita, kuten Perl (skripti-kieli), mutta niitä ei tavallisesti tarvita

Huom! Seuraavat ohjeet on tarkoitettu opiskelijoiden omille koneille. Tite luokissa on jo XAMPPia asennettu etukäteen. Jos jostain syystä XAMPPI ei löydy tai sen halutaan uudelleen asentaa, voidaan suorittaa skriptin
\\jako\koulutusmateriaali\XAMPP\Xampp_Deploy.cmd

Lataaminen

XAMPP voidaan ladata https://www.apachefriends.org/ -sivulta.

Tavallisesti ladataan viimeinen versio oman koneen käyttöjärjestelmälle. Tässä me käydään läpi vain Windows versio

Jos tiedosto ei lataudu automaattisesti, klikka tähän

Ja sitten tähän

Lopuksi tiedosto löytyy Ladatut tiedostot -kansiosta

Asentaminen

Suorittaa asennutiedosto kaksoisklikkamalla sen ja hyväsy ensimmäiset vaiheet

Websivujen kehitykseen tarvitaan kolme asiaa:

Web-palvelinta (Apache)
tietokantojen hallintajärjestelmää (MySQL/MariaDB)
ja web-ohjelmointi kieltä (joka pitää olla PHP, jos kyseessä on WordPress, Drupal tai Joomla).

Niiden lisäksi PHPMyAdmin tarvitaan hallitsemaan helpommin tietokantajärjestelmä. Muut XAMPPin komponentit voidaan poistaa/disabloida.

Muissa vaiheissa voidaan vain paina ”Next” (paitsi viimeisessa vaiheessa)

Pitä oletus C:\Xampp -kansio asennuksen kohdekansiona

Asennuksen aikana voi tulla ilmoituksia avamaan porttia Apachelle tai MySQL palvelimelle palomuurissa. Niitä voidaan hylätä.

Asetustiedoston oikeuksien korjaaminen

XAMPPin asennus poista asetustiedostosta oikeuksia tehdä muutoksia turvallisuuden syistä. Oikeudet on asetettavat takaisin.

Asennuksen jälkeen avaa resurssienhallinta ja löytä C:\Xampp\xampp-control.ini -tiedosto (se on todennakoisesti kansion viimeinen kohta). Paina hiiren oikea painike sen päällä ja avaa ominaisuudet. Huoma, että on parempi, että tiedostojen päätteet ovat näkyvissä.

Jos tiedostojen päätteet eivät ole näkyvissä, vaihta resurssienhallinta -asetuksia tällä tavalla

Lisää oma käyttäjätunus tai ”todennetut käyttäjät” (Authenticated users englanniksi) tiedoston pääsylistaan.

Vaihtoehtoisesti voidaan myös lisätä oma Windowsin käyttäjätunnus

Kun kohde on lisätty listaan, valitsen sen listalta ja varmista, että oikeudet ovat kuvan mukaisia (eli Muokkaus päälle)

Sen jälkeen hyväksy muutokset ja poistu ikkunasta painamalla OK

Perus asetuksia

Suositellaan tehdä pikalinkki XAMPPin hallintapaneliin (C:\Xampp\xampp-control.exe) työpöydässä. Raahaa tiedosto työpöytään ja samalla paina ALT painike luomaan pikalinkki.

Varmista, että olet luonut pikalinkki/pikakuvake, eikä olet vahingossa siirtänyt tiedoston

Avaa XAMPPin hallinta paneeli (Xampp-control.exe).

Hallintapaneelin/Xamppin asetukset

Ennen sitä, että aloitetaan käyttämään XAMPPia olisi hyvää aseta järkeviä asetuksia. Avaa hallintapanelin asetukset ”Config” -painikkeesta.

Asetuksissa voidaan tarvittaessa vaihtaa tekstieditori, esimerkiksi VSCodeen. Oletus teksti editori on Windowsin Notepad, joka riittää monissa tapauksissa, mutta jotkut voivat pitää edistyneempistä tekstieditorista

Paina ”Service and Port Settings” and vaihtaa ensisijainen portti 8000 (tämä pitää olla Apachen todellisen portti. Vaihda tarvittaessa sen mukaan). Sen jälkeen voidaan tallenna ja sulkea hallintapaneelin asetukset

Palvelujen asetukset

Edellisessa vaiheessa on vaihdettu Xamppin tarkistettava portti. Nyt vaihdetaan oikeasti käyttöportti palvelimessa (Apache)

MySQL/MariaDB ei tarvitse muokata, mutta Apache (samaa kuin muut web palvelimet) toimii oletuksena 80 porttissa. Omalla koneella tästä voi joskus voi tulla ongelmia, siksi suositellaan vaihtamaan Apachen portti toiseen porttiin. Tavallisesti asiaan käytetään portti 8000 tai 8080. Voi olla toki jotain muuta porttia, mutta Web palvelimelle nuo kaksi ovat suositut portit.

Avaa Apachen asetukset Apachen Config -painikeesta. Valitsemasi tekstieditori avautuu ja sen avulla voit muokata Apachen asetukset.

Tässä tiedostossa voisimme vaihtaa kaksi asiaa:

1. Vaihta Apachen kuuntelu portti johon muuhun (esim. 8000). Skrolla vähän alaspäin ja etsi rivi, joka alkaa ”Listen” sanalla. Vaihta numeron 8000:

2. Disable SSL. Helpoin tapaa on hakea teksti ”SSL”. Disabloi löydetty rivi lisäämällä riisuaitamerkki rivin eteen:

Seuraava rivi, mitä se löytää on komentti, mutta meidän pitää disabloida samalla tavalla kuin aikaisemmin se rivi, joka tulee heti sen jälkeen:

Tallenta tiedosto ja sulje tekstieditori.

Xamppin käyttö

Käynnistäminen

Käynnistää Apache ja MySQL moduulit:

Varmista, että moduulit tulevat vihreäksi ja Apachen portti on 8000 (tai sinun valitsemasi portti asetuksissa). Sen jälkeen voidaan avata Xamppin kotisivun Apachen ”Admin” -painikkeesta.

Huoma sivun osoite. Kun Apache on käynnissä, web palvelin löytyy osoitteesta http://localhost:8000/. Portti on se, joka on asetettu Apachen asetuksissa.

Sulkeminen

HUOM: On erittäin tärkeä sulkea oikeasti MySQL ennen sitä, että kone suljetaan tai laitetaan lepotilaan. Jos sitä ei tehdä, on mahdollista korruptoida tietokanta ja häviää samalla kaikki töitä, mitä olisi tehty siihen asti (eli sivusto kokonaan häviää)

Huoma, että periaatteessa riittää sulkea MySQL palvelimen, mutta suositellaan sulkea myös Apache ja hallintapaneeli ennen koneen sulkemista.

Tee aina varmuuskopiota sinun projektisi. Eri syistä aina on riski, että tietokanta korruptoi ja kaikki pitää saada takaisin varmuuskopiosta (tai pitää asentaa uudeelleen koko Xampp).

Huoma, että on mahdollista avata useita hallintapaneelia samaan aikaan (vaikka vahingossa). Sulje ylimääräiset instanssit tarvittaessa. Ei riittää, että suljetaan ikkuna ”X” -painikkeella. Ikkuna sulkeutuu, mutta ohjelma jää pyörimään taustalla. Pitää sulkea ”Quit” -painikkeesta. Kellon vierestä olevasta alueesta voidaan tarkista paljonko hallintapaneeli ikkuna on oikeasti auki.