XAMPPin asennus: PHP ja MySQL paikallisesti

01Mikä on XAMPP ja mihin sitä käytetään?

XAMPP on ilmainen paketti, joka tuo koneellesi yhdellä asennuksella Apache-verkkopalvelimen, PHP:n, MariaDB-tietokannan ja phpMyAdmin-hallintapaneelin. Tarkoitus on ajaa PHP:llä kehitetty sivusto omalla koneellasi eli localhostissa ennen sen julkaisemista internetiin.

Paketin nimi tulee sen sisällöstä: X (alustariippumaton), Apache, MariaDB/MySQL, PHP ja Perl. XAMPPin nykyisissä versioissa tietokantana on MariaDB; MariaDB on pitkälti MySQL-yhteensopiva ja näkyy ohjauspaneelissa yhä nimellä MySQL.

XAMPP sopii erinomaisesti oppimiseen, pieniin kokeiluihin ja projektin nopeaan pystyttämiseen. Jos tarvitset eri PHP-versioita usealle projektille tai haluat täsmälleen live-palvelimen kaltaisen ympäristön, konttipohjainen rakenne on joustavampi; kerroimme siitä oppaassamme Dockerin asennus.

02Huomioitavaa ennen asennusta

Lataa XAMPP vain viralliselta sivustolta apachefriends.org. Sivulla on listattuna useita versioita; olennainen ero niiden välillä on PHP-versio. Valitse paketti, jonka PHP-versio on lähimpänä projektisi vaatimaa.

Asenna Windowsissa juurihakemiston lähellä olevaan kansioon, kuten C:\xampp. Program Files -kansio aiheuttaa kirjoitusoikeusongelmia Windowsin käyttäjätilien valvonnan (UAC) vuoksi; asennusohjelma varoittaa tästä myös itse.

• Jos koneellasi on erikseen asennettu MySQL-palvelu tai IIS, portti-ristiriita on mahdollinen; katso alla oleva virheosio.
• Virustorjunta tai palomuuri voi pyytää ensimmäisellä käynnistyksellä lupaa Apachelle ja MySQL:lle; salli vain yksityiset verkot.
• XAMPP on tarkoitettu kehitykseen; sitä ei pidä käyttää live-palvelimena oletusasetuksilla.

03XAMPPin asennus Windowsissa

Windows-asennus koostuu muutamasta näytöstä, ja oletusvalinnat riittävät useimmille käyttäjille.

1. Suorita lataamasi asennusohjelma järjestelmänvalvojana; lue UAC-varoitus ja jatka.
2. Varmista komponenttinäytössä, että Apache, MySQL, PHP ja phpMyAdmin on valittu; poista valinta komponenteilta kuten FileZilla, Mercury ja Tomcat, jos et tarvitse niitä.
3. Valitse asennuskansioksi C:\xampp.
4. Kun asennus on valmis, avaa XAMPP Control Panel; paina Apache- ja MySQL-rivien Start-painikkeita.
5. Kun molemmat rivit muuttuvat vihreiksi, avaa selaimessa osoite http://localhost; XAMPPin tervetulosivun pitäisi näkyä.

04XAMPP Linuxissa ja macOS:ssä

Linux-versio tulee .run-päätteisenä asennusohjelmana ja asentuu kansioon /opt/lampp. Riittää, että teet asennusohjelmasta suoritettavan ja käynnistät sen järjestelmänvalvojan oikeuksin. Asennuksen jälkeen palveluita hallitaan lampp-skriptillä; verkkotiedostot sijaitsevat kansiossa /opt/lampp/htdocs.

macOS:lle on myös oma pakettinsa, mutta Mac-käyttäjillä yleisempiä ovat Homebrew'lla erikseen asennetut PHP ja MariaDB tai Docker. Valitsit minkä tahansa tien, logiikka on sama: verkkopalvelin, PHP ja tietokanta toimivat yhdessä.

chmod +x xampp-linux-*-installer.run
sudo ./xampp-linux-*-installer.run

# Palveluiden hallinta
sudo /opt/lampp/lampp start
sudo /opt/lampp/lampp status
sudo /opt/lampp/lampp stop

05Ensimmäisen PHP-sivun ajaminen

Apache tarjoaa htdocs-kansion tiedostot. Windowsissa tämä kansio on polussa C:\xampp\htdocs ja Linuxissa /opt/lampp/htdocs. Luo sen sisälle kansio nimeltä deneme ja tallenna alla oleva tiedosto nimellä index.php.

Kun avaat selaimessa osoitteen http://localhost/deneme/, näet pitkän taulukon, jossa näkyvät PHP:n versio, asennetut laajennukset ja php.ini:n sijainti. Taulukko osoittaa asennuksen toimivan; poista tiedosto, kun olet valmis, koska se paljastaa palvelimesta yksityiskohtaista tietoa.

<?php
phpinfo();

PHP:n käyttö päätteestä

Jotta voit käyttää XAMPPin PHP:tä komentoriviltä ja Composerin kanssa, lisää kansio C:\xampp\php PATH-muuttujaan. Aja sitten uudessa päätteessä komento php -v. Kävimme riippuvuuksien hallinnan läpi vaihe vaiheelta oppaassamme Composerin asennus.

C:\xampp\php\php.exe -v

06XAMPPin MySQL- ja phpMyAdmin-asetukset

Voit hallita tietokantojasi avaamalla selaimessa osoitteen http://localhost/phpmyadmin. Luo tietokanta vasemman valikon Uusi-valinnalla ja valitse merkistöksi utf8mb4_unicode_ci tai jokin muu utf8mb4-perheen vertailu; ääkköset ja emojit tallentuvat ongelmitta.

XAMPPissa tietokannan root-käyttäjän salasana on oletuksena tyhjä. Vaikka työskentelisit vain omalla koneellasi, on hyvä tapa asettaa salasana ja luoda projekteille erilliset käyttäjät. Salasanan vaihdon jälkeen sinun pitää päivittää myös config.inc.php-tiedoston salasanarivi, jotta phpMyAdmin voi yhdistää.

• phpMyAdminin salasana-asetus on Windowsissa tiedostossa C:\xampp\phpMyAdmin\config.inc.php.
• Käyttäjien, oikeuksien ja SQL-komentojen yksityiskohdat löydät oppaastamme MySQL:n asennus.

CREATE DATABASE proje CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'proje_kullanici'@'localhost' IDENTIFIED BY 'guclu-bir-sifre';
GRANT ALL PRIVILEGES ON proje.* TO 'proje_kullanici'@'localhost';
FLUSH PRIVILEGES;

07Apachen käynnistysvirhe ja porttiongelmat

XAMPPin tunnetuin ongelma on, että Apache muuttuu Start-painikkeen painalluksen jälkeen hetkeksi vihreäksi ja sammuu sitten uudelleen. Ohjauspaneelin alaosan lokiruutu kertoo syyn useimmiten: Port 80 in use tai Port 443 in use. Tämä tarkoittaa, että jokin toinen ohjelma pitää porttia varattuna; syynä voi olla IIS, toinen verkkopalvelin tai jotkin virtualisointi- ja viestintäohjelmat.

Portin käyttäjän selvittäminen

Avaa Komentokehote järjestelmänvalvojana ja aja alla olevat komennot. Ensimmäinen komento näyttää portin käyttäjäprosessin numeron (PID), toinen kyseisen prosessin nimen.

netstat -ano | findstr :80
tasklist /FI "PID eq 1234"

Apachen portin vaihtaminen

Jos et voi sulkea ristiriitaista ohjelmaa, aja Apache toisessa portissa. Avaa Control Panelin Apache-rivin Config-painikkeesta httpd.conf-tiedosto ja muuta alla olevat rivit; avaa sitten sivusto osoitteesta http://localhost:8080. Jos ristiriita on portissa 443, tee sama httpd-ssl.conf-tiedostossa.

Listen 8080
ServerName localhost:8080

Listen 4433
<VirtualHost _default_:4433>

MySQL ei käynnisty

Porttia 3306 voi käyttää koneelle erikseen asennettu MySQL-palvelu; pysäytä palvelu tai vaihda my.ini-tiedostossa portin arvoksi esimerkiksi 3307. »MySQL shutdown unexpectedly» -virheessä ota ensin varmuuskopio kansiosta mysql\data ja lue virheloki; datatiedostojen poistaminen umpimähkään voi rikkoa tietokantasi pysyvästi.

08Paikallisesta live-sivustolle

XAMPPissa toimiva sivusto voi käyttäytyä eri tavalla siirrettäessä se live-palvelimelle: PHP-versio, laajennukset, tiedosto-oikeudet ja tietokanta-asetukset muuttuvat. Siksi ennen livelle siirtymistä on tärkeää käyttää myös paikallisesti palvelimen PHP-versiota ja pitää tietokantayhteyden tiedot koodista erillisessä asetustiedostossa.

Livenä sivun nopeuden ratkaisevat asetukset kuten välimuisti, pakkaus ja kuvien optimointi; käsittelemme nämä asiat nopeus- ja suorituskykyoptimointi -palvelussamme. Kun siirryt paikallisista kokeiluista ammattimaisen yrityksen kotisivujen tai verkkokaupan teknisen alustan pystyttämiseen, palvelin- ja tietoturvapuolen jättäminen asiantuntijatiimille säästää aikaa.

Muita paikallisen kehityksen oppaita löydät asennusoppaat-kategoriasta.