W kilku wiadomościach często pojawiają się pytania jak najszybciej wystartować z Laravelem, jak go zainstalować. Z pomocą przychodzi świetna dokumentacja frameworka, która prowadzi nas właściwie krok po kroku. Mimo to, spróbuję pokazać, jak w praktyce wygląda jego świeża instalacja i wstępna konfiguracja.

1. Instalujemy Composera.
   Composer jest jednym z napopularniejszych narzędzi do zarządzania pakietami, zależnie od systemu operacyjnego jego instalacja może się różnić, jednak nie jest to nic trudnego. Po więcej szczegółow zapraszam na stronę projektu: https://getcomposer.org/doc/00-intro.md
2. Wybieramy miejsce do umieszczenia projektu i w linii poleceń/terminalu wpisujemy:
   
   PHP

   composer create-project --prefer-dist laravel/laravel nazwaProjektu

   1	composer create-project --prefer-dist laravel/laravel nazwaProjektu

   
   W ten sposób bo krótkiej chwili Composer ściągnie nam instalację Laravela i postawi jego instancję
3. Mając zainstalowanego Laravela, potrzebujemy bazy danych. Z tym również nie powinno być problemu, do wyboru mamy ręczną instalację samej bazy mysql (https://dev.mysql.com/downloads/installer/) lub instalację w pakiecie z całym środowiskiem (WAMP, XAMPP).
   Którego wyjścia byśmy nie wybrali musimy mieć działający serwer MySQL, utworzyć w nim bazę i znać dane dostępowe.
   
4. Teraz możezmy już modyfikować zmienne środowiskowe z pliku .env:
   
   PHP

   APP_NAME=Nazwa aplikacji APP_ENV=local APP_KEY=base64:rF5TpPmGqGzUkPK4/SzrFbXTzU+V0SycyQ3o2UoAFW4= APP_DEBUG=true APP_LOG_LEVEL=debug APP_URL=127.0.0.1:8000 //adres aplikacji, domena DB_CONNECTION=mysql DB_HOST=127.0.0.1 //adres serwera mysql DB_PORT=3306 DB_DATABASE=kajaki //nazwa bazy DB_USERNAME=root //nazwa uzytownika DB_PASSWORD= //haslo BROADCAST_DRIVER=log CACHE_DRIVER=file SESSION_DRIVER=file QUEUE_DRIVER=sync REDIS_HOST=127.0.0.1 REDIS_PASSWORD=null REDIS_PORT=6379 MAIL_DRIVER=smtp MAIL_HOST=smtp.mailtrap.io MAIL_PORT=2525 MAIL_USERNAME=null MAIL_PASSWORD=null MAIL_ENCRYPTION=null PUSHER_APP_ID= PUSHER_APP_KEY= PUSHER_APP_SECRET=

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33

   APP_NAME=Nazwa aplikacji APP_ENV=local APP_KEY=base64:rF5TpPmGqGzUkPK4/SzrFbXTzU+V0SycyQ3o2UoAFW4= APP_DEBUG=true APP_LOG_LEVEL=debug APP_URL=127.0.0.1:8000 //adres aplikacji, domena   DB_CONNECTION=mysql DB_HOST=127.0.0.1 //adres serwera mysql DB_PORT=3306 DB_DATABASE=kajaki //nazwa bazy DB_USERNAME=root //nazwa uzytownika DB_PASSWORD= //haslo   BROADCAST_DRIVER=log CACHE_DRIVER=file SESSION_DRIVER=file QUEUE_DRIVER=sync   REDIS_HOST=127.0.0.1 REDIS_PASSWORD=null REDIS_PORT=6379   MAIL_DRIVER=smtp MAIL_HOST=smtp.mailtrap.io MAIL_PORT=2525 MAIL_USERNAME=null MAIL_PASSWORD=null MAIL_ENCRYPTION=null   PUSHER_APP_ID= PUSHER_APP_KEY= PUSHER_APP_SECRET=

   
    
5. Spróbujmy teraz zainstalować domyślny system autentykacji w Laravelu, w tym celu za pomocą Artisana wybieramy:
   
   PHP

   php artisan make:auth

   1	php artisan make:auth

   
   Dzięki temu stworzone zostaną kontrolery i modele niezbędne do procesu autentykacji.
6. Przechodzimy do pliku 2014_10_12_000000_create_users_table.php w katalogu app/database/migrations i dodajemy linijkę:
   
   PHP

   $table->char('api_token', 60)->nullable();

   1	$table->char('api_token', 60)->nullable();

   
   tak by cały kod funkcji up() wyglądał następująco:
   
   PHP

   public function up() { Schema::create('users', function (Blueprint $table) { $table->increments('id'); $table->string('name'); $table->string('email')->unique(); $table->string('password'); $table->char('api_token', 60)->nullable(); $table->rememberToken(); $table->timestamps(); }); }

   1 2 3 4 5 6 7 8 9 10 11 12

   public function up()     {         Schema::create('users', function (Blueprint $table) {             $table->increments('id');             $table->string('name');             $table->string('email')->unique();             $table->string('password');             $table->char('api_token', 60)->nullable();             $table->rememberToken();             $table->timestamps();         });     }

   
   Dzięki temu dodamy również kolumnę do przechowywania tokenu do autoryzacji API.
7. W celu migracji schematów baz, wywołujemy:
   
   PHP

   php artisan migrate

   1	php artisan migrate

   
   Jeśli w trakcie migracji otrzymacie błąd:
   Syntax error or access violation: 1071 Specified key was too long; max key length is 767 bytes

   oznacza to, iż używamy starszej wersji MySQL, w takiej sytuacji należy edytować plik AppServiceProvider z katalogu Providers i nadpisać funkcję boot:

   PHP

   use Illuminate\Support\Facades\Schema; /** * Bootstrap any application services. * * @return void */ public function boot() { Schema::defaultStringLength(191); }

   1 2 3 4 5 6 7 8 9 10 11

   use Illuminate\Support\Facades\Schema;   /** * Bootstrap any application services. * * @return void */ public function boot() {     Schema::defaultStringLength(191); }

8. Udana migracja pozwoli nam na uruchomienie aplikacji poprzez wywołanie serwera:
   PHP

   php artisan serve

   1	php artisan serve

   i wybór: 127.0.0.1:8000
   W prawym górnym rogu pojawi się również menu logowania, w tym miejscu powinno być możliwe logowanie, rejestracja i wylogowanie.

9. Ostatni etap to próba przetestowania naszego API. W tym celu spróbujmy dodać klucz api w tabeli users dla wybranego usera, np:
   
10. Próbujemy uruchomić jedyne dostępne w routes/api.php żądanie api zwróci nam dane użytkownika:

W ten sposób powinniśmy otrzymać wynik w formacie JSON:

Tak oto mamy szybko i łatwo (zaledwie 10 kroków!) przygotowany szkielet aplikacji, która świetnie nadaje się do rozbudowy, czy to w kierunku API, czy też aplikacji webowej wykorzystującej domyślny frontend Laravela.