Laravel - inštalácia a základná konfigurácia

Inštalácia samotného frameworku je rýchla a nenáročná. Pred tým než sa do inštalácie pustíte sa však uistite, že vaše vývojové prostredie spĺňa všetky požiadavky. Serverové požiadavky podľa verzie frameworku nájdete v dokumentácii.

Podmienkou pre inštaláciu je mať nainštalovaný Composer (správca závislostí).

Stačí zavolať príkaz

composer global require laravel/installer

Po pridaní globálneho vendor adresára do $PATH (premennej prostredia) môžete používať na vytvorenie nového projektu jednoduché volanie laravel new nazov-projektu Toto volanie vytvorí nový Laravel projekt a nainštaluje všetky preddefinované závislosti.

Vývojové prostredie, lokálny server

Možností ako pracovať lokálne je niekoľko. PHP CLI od verzie 5.4.0 disponuje vstavaným webserverom, ktorý je pre potreby vývoja webu plne dostačujúci. Pozor však na obmedzenia (webserver napríklad využíva pri spracovaní požiadavok jediný jednovláknový proces) a vstavaný webserver používajte len na vývoj a testovacie účely. Na spustenie servera môžete použiť artisan príkaz

php artisan serve

Ak chcete používať o niečo robustnejšie riešenie, môžete skúsiť Valet (osobne sa mi osvedčil najviac), alebo virtuálny Homestead, ktorý je však už trochu tažším kalibrom a na môj vkus spotrebuje priveľa pamäte.

Konfigurácia

Konfiguračné súbory sa nachádzajú v adresári config. Niekoľko konštánt je už vytiahnutých do .env súboru nachadzjúceho sa v koreňovom adresári projektu, kde je možné konfigurovať konštanty v závislosti od prostredia – čo je mimochodom veľmi praktická vec. Odporúčam všetky konfiguračné konštanty, ktoré sú závislé od použitého prostredia (testovanie, produkcia, …) nastavovať v tomto súbore a mať ich tak na jednom mieste.

V rámci konfigurácie skontrolujte práva adresárov storage a bootstrap/cache. Webový server by mal byť schopný do uvedených adresárov zapisovať. Aplikačný kľúč by mal byť vygenerovaný vo vašom .env súbore. Ak tam z nejakého dôvodu nie je, použite príkaz

php artisan key:generate

Tento kľúč je veľmi dôležitý z bezpečnostného hľadiska. Používa sa na šifrovanie session a ďalších kritických dát.

Webserver

Dôležité je nakonfigurovať web root vášho web servera do adresára public, kde sa nachádza front controller. Ak bude web server hľadať súbor index.php v koreňovom adresári projektu, aplikácia pochopiteľne nebude fungovať.

V prípade, že používate Apache, uistite sa, že máte povolény mod_rewrite. Ak máte problém s defaultným .htaccess súborom, skúste alternatívu z dokumentácie.

Všetko pripravené?

Ak inštalácia prebehla v poriadku a vy ste správne nakonfigurovali web server, mali by ste vidieť defaultnú bielu stránku s odkazmi na dokumentáciu a pod.

Ak sa vám táto stránka zobrazuje, gratulujem. Zvládli ste inštaláciu a môžete sa pustiť do vývoja aplikácie.

V prípade, že sa objavila chyba, skontrolujte vyššie uvedené body, alebo napíšte na fórum.

V ďalšom blogu si povieme viac o routingu v Laraveli.