Laravelin asennus | @harrasteblogi

Tiivistelmä

Oman verkkosovelluksen rakentaminen alkaa usein yhdestä kysymyksestä: millä työkaluilla projekti kannattaa toteuttaa? PHP tarjoaa tähän monipuoliset mahdollisuudet, mutta pelkkä ohjelmointikieli ei vielä ratkaise sovelluksen rakennetta, tietokantayhteyksiä tai käyttäjien hallintaa. Näiden asioiden toteuttamiseen tarvitaan toimiva kehitysympäristö ja sopiva ohjelmistokehys.

Laravel on yksi vaihtoehto, jonka avulla verkkosovelluksen rakentaminen voidaan aloittaa selkeältä pohjalta. Se sisältää valmiita ratkaisuja moniin kehitystyön tavallisiin tarpeisiin, kuten sivujen reititykseen, tietokantojen käsittelyyn ja käyttäjien tunnistautumiseen. Ennen ensimmäisen sovelluksen tekemistä Laravel täytyy kuitenkin asentaa tietokoneelle.

Tässä oppaassa käydään läpi Laravelin asennus vaihe vaiheelta. Samalla tutustut tarvittaviin ohjelmistoihin, projektin kansiorakenteeseen, tietokannan määrittämiseen ja ensimmäisen verkkosivun luomiseen. Ohje sopii erityisesti Laravel-kehityksen aloittamiseen paikallisessa ympäristössä.

1. Mitä Laravelin asentamiseen tarvitaan?

Laravel-projektin käynnistäminen edellyttää muutamaa perusohjelmistoa. Niiden tehtävänä on mahdollistaa PHP-koodin suorittaminen, projektin riippuvuuksien asentaminen ja tarvittaessa tietojen tallentaminen tietokantaan.

Ennen asennusta varmista, että tietokoneeltasi löytyvät seuraavat työkalut:

PHP: Laravel-sovelluksen suorittamiseen tarvittava ohjelmointikieli.
Composer: PHP-projektien riippuvuuksien hallintaan tarkoitettu pakettienhallintatyökalu.
Git: Versionhallintajärjestelmä, jonka avulla muutoksia voidaan seurata.
Koodieditori: Esimerkiksi Visual Studio Code ohjelmakoodin kirjoittamiseen.
Tietokanta: Esimerkiksi MySQL, PostgreSQL tai SQLite sovelluksen tietojen tallentamiseen.

Laravelin järjestelmävaatimukset riippuvat käytettävästä versiosta. Tarkista siksi PHP vähimmäisversio ja tarvittavat laajennukset Laravelin virallisesta dokumentaatiosta ennen asennusta.

2. PHP asentaminen tietokoneelle

Ensimmäinen käytännön vaihe on PHP asentaminen. Asennustapa vaihtelee käyttöjärjestelmän mukaan, joten valitse omaan ympäristöösi sopiva vaihtoehto.

Windows

Windowsissa PHP voi asentaa erikseen tai käyttää valmista kehitysympäristöä, kuten Laragonia. Myös XAMPP on vaihtoehto, jos tarvitset PHP lisäksi esimerkiksi Apache-palvelimen ja MySQL-tietokannan.

Jos asennat PHP erikseen, varmista, että sen suorituspolku lisätään Windowsin PATH-ympäristömuuttujaan. Näin PHP-komento toimii komentokehotteessa ja PowerShellissä.

macOS

Macilla PHP asentaminen onnistuu esimerkiksi Homebrew-paketinhallinnan kautta. Avaa terminaali ja suorita:

brew install php

Ubuntu Linux

Ubuntu-käyttöjärjestelmässä PHP voidaan asentaa seuraavilla komennoilla:

sudo apt update
sudo apt install php php-cli php-mbstring php-xml php-curl php-zip php-mysql php-sqlite3

Kun asennus on valmis, tarkista PHP toiminta:

php -v

Terminaalin pitäisi näyttää asennetun PHP-version tiedot. Jos komentoa ei tunnisteta, tarkista asennus ja järjestelmän PATH-asetukset.

3. Composerin asentaminen

PHP jälkeen tarvitaan Composer. Sen avulla Laravel lataa projektissa tarvittavat kirjastot ja huolehtii niiden versioiden hallinnasta. Ilman Composeria Laravel-projektin riippuvuuksien asentaminen olisi huomattavasti työläämpää.

Composerin asennuspaketti ja käyttöjärjestelmäkohtaiset ohjeet löytyvät viralliselta sivustolta:

https://getcomposer.org

Asennuksen jälkeen avaa uusi terminaali-ikkuna ja suorita:

composer --version

Jos näet versionumeron, Composer on käyttövalmis.

On hyvä varmistaa myös, että sekä PHP että Composer toimivat samassa komentoriviympäristössä. Tämä ehkäisee yleisiä asennusongelmia myöhemmissä vaiheissa.

4. Uuden Laravel-projektin luominen

Kun tarvittavat työkalut ovat käytössä, voidaan siirtyä varsinaiseen Laravel-asennukseen.

Avaa terminaali ja siirry kansioon, johon haluat tallentaa projektisi. Esimerkiksi:

cd Projects

Luo uusi Laravel-sovellus Composerin avulla:

composer create-project laravel/laravel oma-projekti

Komennossa oma-projekti tarkoittaa uuden projektin kansiota. Voit vaihtaa nimen haluamaksesi.

Composer hakee Laravelin tarvittavat paketit ja luo projektin kansiorakenteen automaattisesti. Asennuksen kesto riippuu internetyhteydestä ja tietokoneen suorituskyvystä.

Kun prosessi on valmis, siirry luotuun kansioon:

cd oma-projekti

Nyt Laravel-sovelluksen perusrakenne on olemassa. Voit avata projektin esimerkiksi Visual Studio Code -editorissa:

code .

5. Laravel-sovelluksen käynnistäminen

Asennettu projekti kannattaa testata heti, jotta mahdolliset ongelmat havaitaan ennen varsinaisen kehitystyön aloittamista.

Laravel sisältää Artisan-komentorivityökalun, jonka kautta sovelluksen kehityspalvelin voidaan käynnistää.

Suorita projektikansiossa:

php artisan serve

Terminaali ilmoittaa paikallisen palvelimen osoitteen. Tavallisesti se on:

http://127.0.0.1:8000

Avaa osoite verkkoselaimessa. Jos kaikki toimii oikein, näet Laravelin oletusarvoisen aloitussivun.

Paikallinen kehityspalvelin on tarkoitettu sovelluksen testaamiseen ja kehittämiseen. Tuotantokäytössä palvelimen asetukset ja tietoturva täytyy suunnitella erikseen.

6. Laravel-projektin kansiorakenteeseen tutustuminen

Ensimmäisellä käyttökerralla Laravelin kansiorakenne voi näyttää laajalta. Sen ymmärtäminen on kuitenkin tärkeää, sillä eri tiedostoilla ja kansioilla on omat tehtävänsä.

Keskeisimmät kansiot ovat:

app/

Tänne sijoitetaan sovelluksen keskeinen PHP-koodi. Kansio sisältää esimerkiksi mallit, ohjaimet ja muut sovelluksen toimintaa määrittelevät luokat.

routes/

Reititystiedostot määrittelevät, mitä tapahtuu käyttäjän avatessa tietyn osoitteen. Verkkosivujen tavallisimmat reitit löytyvät web.php-tiedostosta.

resources/

Sisältää käyttöliittymän näkymät ja muita käyttöliittymän kehittämiseen liittyviä resursseja. Laravelin Blade-templating-järjestelmää käytetään näkymien rakentamiseen.

database/

Tietokantaan liittyvät migraatiot, siemenajot ja mahdolliset tietokantatiedostot sijaitsevat tässä kansiossa.

public/

Sovelluksen julkisesti saatavilla olevat tiedostot, kuten kuvat ja tyylitiedostot, sijoitetaan tähän kansioon.

config/

Sisältää sovelluksen asetustiedostot.

storage/

Sisältää sovelluksen luomia tiedostoja, lokeja ja muita tallennettavia resursseja.

Lisäksi projektin juuresta löytyy .env-tiedosto. Siinä määritellään esimerkiksi sovelluksen ympäristöasetuksia ja tietokantayhteyden tietoja. Tiedostoa ei pidä jakaa julkisesti tai tallentaa versionhallintaan.

7. Ensimmäisen oman sivun luominen

Laravelin asennuksen jälkeen on hyvä kokeilla käytännössä, kuinka uusi sivu lisätään sovellukseen.

Avaa projektin routes/web.php-tiedosto. Lisää sinne seuraava koodi:

use Illuminate\Support\Facades\Route;

Route::get('/tervehdys', function () {
    return 'Tervetuloa ensimmäiseen Laravel-sovellukseeni!';
});

Tallenna tiedosto ja avaa selaimessa:

http://127.0.0.1:8000/tervehdys

Näytölle pitäisi ilmestyä kirjoittamasi tervehdysteksti.

Esimerkki havainnollistaa Laravelin reitityksen toimintaa. Route::get() määrittelee, miten sovellus vastaa GET-pyyntöön, joka kohdistuu annettuun osoitteeseen.

Myöhemmin reitit voidaan yhdistää ohjaimiin ja näkymiin, jolloin sovelluksen rakenne pysyy selkeänä myös suuremmissa projekteissa.

8. Tietokantayhteyden määrittäminen

Monet verkkopalvelut tarvitsevat tietokannan esimerkiksi käyttäjätietojen, tilausten ja tuotteiden tallentamiseen. Laravel tukee useita tietokantajärjestelmiä, joten voit valita projektisi tarpeisiin sopivan vaihtoehdon.

MySQL-tietokantayhteys määritellään projektin .env-tiedostossa.

Esimerkiksi:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel_db
DB_USERNAME=root
DB_PASSWORD=

Luo ensin MySQL-palvelimelle laravel_db-niminen tietokanta. Muuta tarvittaessa käyttäjätunnus ja salasana vastaamaan oman ympäristösi asetuksia.

Tämän jälkeen voit suorittaa tietokantamigraatiot:

php artisan migrate

Laravel luo tarvittavat tietokantataulut projektin migraatiotiedostojen perusteella.

Vaihtoehtoisesti voit käyttää SQLite-tietokantaa, joka soveltuu hyvin esimerkiksi pieniin projekteihin ja paikalliseen kehitykseen.

9. Hyödylliset Artisan-komennot

Artisan on yksi Laravel-kehityksen tärkeimmistä työkaluista. Sen avulla voit luoda uusia tiedostoja, hallita tietokantaa ja tarkastella sovelluksen rakennetta suoraan komentoriviltä.

Tässä muutamia hyödyllisiä komentoja:

Laravel-version tarkistaminen:

php artisan --version

Uuden ohjaimen luominen:

php artisan make:controller UserController

Uuden mallin luominen:

php artisan make:model Product

Migraatiotiedoston luominen:

php artisan make:migration create_products_table

Sovelluksen reittien tarkistaminen:

php artisan route:list

Välimuistien tyhjentäminen:

php artisan optimize:clear

Kun opit käyttämään näitä komentoja, monet kehitystyön rutiinitehtävät hoituvat nopeasti ilman manuaalista tiedostojen luomista.

10. Tavallisimmat Laravelin asennusongelmat

Vaikka Laravelin asennus on yleensä suoraviivaista, ensimmäisellä käyttökerralla voi tulla vastaan muutamia tyypillisiä ongelmia.

PHP-versio ei täytä vaatimuksia. Jos Composer ilmoittaa, ettei käytössä oleva PHP-versio ole yhteensopiva Laravelin kanssa, asenna tuettu versio ja varmista, että komentorivi käyttää sitä.

PHP-laajennuksia puuttuu. Laravel tarvitsee tiettyjä PHP-laajennuksia toimiakseen. Tarkista Composerin virheilmoitus ja asenna puuttuvat laajennukset.

Composer-komentoa ei löydy. Tämä tarkoittaa yleensä sitä, ettei Composerin asennuspolku ole järjestelmän PATH-muuttujassa. Tarkista asennus ja käynnistä terminaali uudelleen.

Tietokantayhteys epäonnistuu. Tarkista .env-tiedoston tietokanta-asetukset, tietokannan nimi sekä palvelimen tila.

Tiedostojen käyttöoikeudet aiheuttavat ongelmia. Laravel tarvitsee kirjoitusoikeudet erityisesti storage– ja bootstrap/cache-kansioihin. Varmista, että käyttöoikeudet on määritetty oikein.

Monissa tilanteissa myös seuraava komento auttaa poistamaan vanhoista asetuksista johtuvia ongelmia:

php artisan optimize:clear

11. Mitä Laravelin asennuksen jälkeen kannattaa tehdä?

Kun Laravel toimii paikallisessa ympäristössä, seuraava vaihe on tutustua tarkemmin sen tarjoamiin kehitystyökaluihin.

Aloita Blade-näkymistä, joiden avulla voit rakentaa verkkosivuston käyttöliittymän. Tutustu tämän jälkeen Eloquent ORM -järjestelmään, joka helpottaa tietokantojen käsittelyä PHP-koodin kautta.

Myös ohjainten, reitityksen ja tietokantamigraatioiden ymmärtäminen kannattaa ottaa varhaiseksi tavoitteeksi. Näiden avulla pystyt rakentamaan sovelluksia, joissa käyttöliittymä, liiketoimintalogiikka ja tietojen tallennus toimivat yhdessä.

Jos suunnittelet laajempaa projektia, tutustu myös Laravelin autentikointiratkaisuihin, testaukseen ja välimuistin hallintaan.

Yhteenveto

Laravelin käyttöönotto muodostuu muutamasta selkeästä vaiheesta: PHP asentamisesta, Composerin määrittämisestä ja uuden projektin luomisesta. Kun nämä ovat kunnossa, sovelluksen voi käynnistää paikallisesti ja aloittaa ensimmäisten sivujen rakentamisen.

Asennuksen jälkeen kannattaa käyttää aikaa projektin kansiorakenteen ymmärtämiseen ja opetella Artisan-komentorivityökalun perusteet. Ne muodostavat hyvän pohjan jatkokehitykselle.

Laravel tarjoaa monipuoliset työkalut erilaisten verkkosovellusten toteuttamiseen. Kun kehitysympäristö on asennettu oikein, voit siirtyä teknisistä valmisteluista itse sovelluksen rakentamiseen.

Lisää ohjeita, esimerkkejä ja ajantasaiset asennusvaatimukset löydät Laravelin virallisesta dokumentaatiosta osoitteesta https://laravel.com/docs.

Liittyvät kategoriat

Artikkeleita 2 053 artikkelia IT 1 979 artikkelia Kotisivut 1 222 artikkelia Laravel 2 artikkelia Nettisivut 1 222 artikkelia PHP 3 artikkelia Verkkokehitys 1 298 artikkelia Verkkosivut 1 421 artikkelia Verkkotyökalu 1 211 artikkelia

Usein kysytyt kysymykset

1. Mikä Laravel on?

Laravel on PHP-ohjelmointikieleen perustuva web-kehityskehys, jonka avulla voidaan rakentaa verkkosivustoja, verkkokauppoja, API-rajapintoja ja erilaisia verkkosovelluksia. Se sisältää valmiita työkaluja esimerkiksi reititykseen, tietokantojen hallintaan ja käyttäjien tunnistautumiseen.

2. Mitä ohjelmistoja Laravelin asentaminen vaatii?

Laravelin asentamiseen tarvitaan PHP, Composer ja Laravel-version edellyttämät PHP-laajennukset. Lisäksi suositeltavia työkaluja ovat Git-versionhallinta ja koodieditori, kuten Visual Studio Code.

3. Voiko Laravelin asentaa Windows-tietokoneelle?

Kyllä. Laravel toimii Windowsissa, macOS:ssä ja Linuxissa. Windowsissa voit asentaa tarvittavat ohjelmistot erikseen tai käyttää valmista kehitysympäristöä, kuten Laragonia.

4. Onko Laravel ilmainen?

Kyllä. Laravel on avoimen lähdekoodin ohjelmistokehys, jonka voi ladata ja ottaa käyttöön maksutta. Myös sen lähdekoodi on vapaasti saatavilla GitHubissa.

5. Mihin Composeria tarvitaan Laravelissa?

Composer huolehtii PHP-projektin riippuvuuksien hallinnasta. Laravel käyttää sitä tarvittavien kirjastojen lataamiseen, asentamiseen ja päivittämiseen. Composer on keskeinen osa Laravelin asennusprosessia.

6. Kuinka kauan Laravelin asentaminen kestää?

Tavallisesti Laravelin perusasennus kestää muutamasta minuutista noin kymmeneen minuuttiin. Aikaan vaikuttavat tietokoneen suorituskyky, internetyhteys ja se, ovatko PHP ja Composer jo valmiiksi asennettuina.

7. Miten Laravel-projekti käynnistetään?

Siirry ensin projektin kansioon komentorivillä ja suorita komento php artisan serve. Tämän jälkeen voit avata selaimessa osoitteen http://127.0.0.1:8000 ja tarkastella sovellusta.

8. Tarvitseeko Laravel toimiakseen MySQL-tietokannan?

Ei välttämättä. Laravel tukee useita tietokantajärjestelmiä, kuten MySQL:ää, PostgreSQL:ää ja SQLitea. Sopiva vaihtoehto riippuu projektin käyttötarkoituksesta ja vaatimuksista.

9. Mikä on Artisan Laravelissa?

Artisan on Laravelin oma komentorivityökalu, jonka avulla voidaan suorittaa erilaisia kehitystehtäviä. Sen avulla voit esimerkiksi luoda ohjaimia, malleja ja migraatioita sekä tarkistaa sovelluksen reitit.

10. Mistä löydän lisää ohjeita Laravelin käyttöön?

Laajin ja ajantasaisin tietolähde on Laravelin virallinen dokumentaatio osoitteessa https://laravel.com/docs. Sieltä löydät asennusohjeet, koodiesimerkit ja tarkemmat selitykset Laravelin eri ominaisuuksista.