Lekce 2 - Instalace Laravel a zprovoznění projektu

V minulé lekci, Úvod do Laravel frameworku pro PHP, jsme se uvedli do PHP frameworku Laravel a stručně jsme si řekli, jaké znalosti budeme potřebovat pro práci s ním.

V dnešním PHP tutoriálu se podíváme jak nainstalovat Laravel jako základ naší aplikace. Tuto instalaci provedeme pomocí nástroje Composer a příkazové řádky.

Potřebný software

Jako první si připravíme správný software, který budeme potřebovat.

Webový server

Budu předpokládat, že máte nainstalovaný a zprovozněný webový server Apache + PHP + MySQL. Pokud ne, doporučuji pro začátečníky nainstalovat balíček XAMPP.

Pro aktuální Laravel budete potřebovat PHP 7.3 nebo novější.

Následně bych doporučil nějaké pokročilejší IDE pro vývoj a práci s frameworkem. Nejlepší volbou je PhpStorm, který já sám používám a budu ho i používat v tomto kurzu. Ulehčí práci nejen se samotným vývojem, ale též s ostatními úkony jako např. s Git systémem. Jako free alternativu lze použít i NetBeans, který dokáže taktéž pomoci s vývojem na rozdíl od jednodušších editorů. Pokud to však myslíme s vývojem vážně, měli bychom sáhnout po profesionálnějším softwaru.

Dále pro samotnou instalaci použijeme snad obecně nejrozšířenější způsob instalace v PHP a to nástroj Composer. Laravel na něm staví jak samotnou instalaci, tak i další rozšíření. Tudíž je potřeba ho také stáhnout a nainstalovat nebo to celé nechat na PhpStorm, který má i zabudované prostředky přímo pro práci s tímto nástrojem. Pokud jste jej nikdy nepoužívali, nainstalujte jej pomocí místního článku Composer.

Také se prosím ujistěte, že máte nainstalovaná následující rozšíření pro PHP:

• BCMath
• Ctype
• Fileinfo
• JSON
• Mbstring
• OpenSSL
• PDO
• Tokenizer
• XML

Pokud jste použili odkaz výše pro instalaci XAMPP, tato rozšíření jsou již automaticky zahrnutá. Pro zjištění, zda-li jsou tato rozšíření nainstalovaná a aktivovaná, lze pouze zavolat jednoduchou PHP funkci phpinfo() a projít si tabulku, kterou vypisuje.

Vytvoření nového projektu

Začneme vytvořením nového projektu v Laravel frameworku.

Instalace

Instalovat budeme přes Composer a to buď ručně nebo přes PhpStorm, pokud toto IDE používáte. Jaký způsob zvolíte záleží na vás.

Instalace ručně pomocí Composer

Composer je nástroj třetích stran pro instalaci a správu závislostí projektů v PHP obecně. Stáhne nám základ Laravel aplikace a i všechny další potřebné knihovny. Pokud tedy Composer již máte nainstalovaný a připravený, můžeme si vytvořit nový Laravel projekt, kdy nám i instalátor zkontroluje všechny potřebné závislosti. Pokud nějaké chybí, samy se doinstalují (to může chvíli trvat).

Pro projekt si vytvořme nějakou složku, např. first-application, a následně pomocí příkazového řádku spustíme příkaz pro vytvoření struktury aplikace:

composer create-project --prefer-dist laravel/laravel:8.2.0 first-application

Pokud konzole hlásí chybu, že nelze nainstalovat Laravel díky nekompatibilní PHP verzi, zkuste příkaz níže:

composer create-project laravel/laravel first-application

Díky tomu budete moct nainstalovat Laravel na jiné verzi PHP. Některé věci se mohou v novější verzi dělat trošku jinak a je třeba kód trochu upravit.

Instalace pomocí PhpStorm

Pokud jste se rozhodli pracovat v PhpStorm a máte vše nainstalováno, zbývá už jen vytvoření samotného projektu. To provedeme obdobně jako v každém jiném IDE, kliknutím na tlačítko pro vytvoření nového projektu.

V nově otevřeném okně se zobrazí průvodce a my vybereme jako typ projektu Composer Project. V dalších krocích:

1. Vyplníme název projektu, např. first-application, společně s cestou, kam se má uložit.
2. Dále nastavíme, že chceme stáhnout Composer, a vybereme PHP interpret.
3. V neposlední řadě zvolíme, co budeme pomocí Composeru vlastně instalovat. V našem případě to tedy bude Laravel framework a to konkrétně balíček laravel/laravel. Ten obsahuje základní kostru aplikace společně s již předpřipravenými komponentami, které se nejběžněji používají, jako např. databázová tabulka uživatelů.

Pokud pracujete s PhpStorm IDE poprvé na operačním systému Windows, je možné, že instalace vás dále nepustí kvůli chybějícímu PHP interpretovi. Ten lze jednoduše nastavit otevřením podokna vedle rozbalovací nabídky pro vybrání daného interpreta a následně přidáním souboru php.exe přes rozbalovací nabídku ikonky plus vlevo nahoře. Poté podokno stačí zavřít a zvolit přidaný PHP interpret v rozbalovací nabídce. Tento proces je popsaný následujícím GIF obrázkem:

Tímto vytvoříme první projekt postavený na Laravel frameworku v rámci PhpStorm IDE pomocí nástroje Composer.

Proces instalace může zabrat pár minut. Buďte proto trpěliví.

Spuštění projektu

Když již máme projekt vytvořený i s nainstalovaným Laravel frameworkem, je načase ho spustit v rámci našeho webového serveru a podívat se na výsledek. U spuštění máme na vyběr z několika možností.

Možnost 1: Spuštění pomocí vestavěného serveru

Nejjednodušší možnost, jak Laravel projekt spustit, nevyžaduje žádnou další konfiguraci. Projekt spustíme pomocí vestavěného webového serveru v PHP. Stačí zavolat následující příkaz ve složce projektu vždy, když budeme chtít pracovat na naší aplikací:

php artisan serve

Může se stát, že váš antivirus (zejména Avast), bude chtít po načtení stránky soubor server.php přesunout do "virové truhly". Pokud se tak stane, obnovte ho a zároveň nezapomeňte přidat výjimku pro tento soubor i pro složku s projektem.

Možnost 2: Spuštění pomocí Laravel Homestead

Laravel nabízí oficiální balíček Laravel Homestead využívající prostředí Vagrant. Laravel Homestead běží nezávisle ve virtuálním stroji, což může být pro některé mínusem, jelikož je potřeba větší operační paměť a mít vůbec podporu pro virtuální prostředí. Na druhou stranu se nemusíte o nic starat a jakmile ho jednou nainstalujete, konfigurace a přidávání nových projektů již bude hračkou.

Bohužel vysvětlování instalace tohoto prostředí a jeho konfigurace je nad rámec tohoto kurzu. O Laravel Homestead si můžete přečíst v oficiální dokumentaci, kde jsou instalace a konfigurace podrobně popsaný.

Možnost 3: Spuštění pomocí Apache serveru

Je jasné, že pro spuštění projektu pod Apache serverem je potřeba, aby server běžel a aby složka projektu byla umístěna někde, kam má Apache přístup. Co už tak jasné není, je, že před samotným spuštěním budeme muset nastavit ještě pár přesměrování.

Směrování

Nejprve si je potřeba uvědomit, že adresářová struktura projektu je stavěná tak, že jeho zobrazení probíhá až po vstupu do složky public/, kde se nachází soubor index.php. Tuto složku budeme též nastavovat jako kořenovou složku v Apache. Jako bonus si i nastavíme URL adresu first-application.local jako přístupovou adresu pro náš projekt.

Nejprve je třeba upravit soubor C:/xampp/apache/conf/extra/httpd-vhosts.conf pro Windows (záleží, kam jste XAMPP nainstalovali) nebo /etc/apache2/sites-available/000-default.conf pro Linux. Do souboru přidáme následující kód:

<VirtualHost *:80>
    DocumentRoot "cesta/k/projektu/public"
    ServerName first-application.local
    <Directory />
        AllowOverride All
        Require all granted
        DirectoryIndex index.php
    </Directory>
</VirtualHost>

Následně též musíme s administrátorskými právy upravit soubor hosts, který nalezneme v C:/Windows/System32/drivers/etc/hosts pro Windows nebo v /etc/hosts pro Linux. Svůj textový editor tedy musíte nejprve spustit jako administrátor, aby bylo možné soubor uložit. Poté do něj jen přidáme následující řádek:

127.0.0.1       first-application.local

Nyní již stačí jen uložit a restartovat Apache (buď přes kontrolní panel XAMPP, nebo přes příkaz sudo service apache2 restart v Linuxovém terminálu).

Výsledek

Ať už jste se rozhodli pro kteroukoliv metodu spuštění projektu, dostáváme se k dnešnímu výsledku. Po zadání příslušné URL adresy do webového prohlížeče se vám zobrazí podobné okno, jako vidíte níže na obrázku. Pro vestavěný server bude URL adresa http://127.0.0.1:8000/ a pro Apache nebo Laravel Homestead http://first-application.local:

Uvítací obrazovka může být i v tmavém režimu, tak se nebojte, že máte něco trochu jinak

Pokud toto okno vidíte, potom jste vše udělali správně. Pokud se vám tato stránka z nějakého důvodu nezobrazuje, doporučuji znovu poctivě projít návod nebo třeba zkusit jiný způsob spuštění. A když již opravdu nebudete vědět kudy kam, můžete vždy využít komentářů pod článkem, kdy vám já nebo někdo jiný může pomoci.

Příště, v lekci První aplikace v Laravel, začneme vytvářet svou první aplikaci v Laravel frameworku. Já prozradím, že se bude jednat o jednoduchou kalkulačku, takže se máte na co těšit!

 

Měl jsi s čímkoli problém? Zdrojový kód vzorové aplikace je ke stažení každých pár lekcí. Zatím pokračuj dál, a pak si svou aplikaci porovnej se vzorem a snadno oprav.