Laravel: Instalare și noțiuni de bază - Partea 1

[sNok3]

 

Introducere noțiuni de bază Laravel

Ce este Laravel? Laravel este un framework care folosește ca limbaj de programare PHP. Fiind un framework, înseamnă ca pune la dispoziție developerilor web o serie de unelte pentru a crea site-uri mai rapid, folosind ceea ce în engleză se numesc "best practices" și o sintaxa clară, ceea ce permite învățarea rapida a utilităților pe care Taylor Otwell (creatorul Laravel) împreună cu contribuitorii de pe GitHub le-au pus la dispoziția noastră. O altă caracteristică a acestui framework este arhitectura MVC (Model View Controller), care permite comunicarea dintre bază de date (care este manipulată prin ORM), backend (partea de cod și algoritmi) și frontend (partea vizuală)

 

Acest framework permite utilizarea pachetelor valabile în Composer (o unealtă care gestionează dependențe), dar și cele valabile în NPM (Node Package Manager) în mod ușor și rapid, lăsând developerii să se concentreze mai mult pe partea de creație.

 

Laravel este un framework care suportă foarte bine scalabilitatea, adică abilitatea unei aplicații de a "crește" cu numărul utilizatorilor, permițând o continuitate în serviciile oferite, fară a crea probleme de performanță care ar putea afecta utilizatorii sau baza/bazele de date folosite de catre aplicații.

 

Instalare dependențe Laravel

Instalarea acestui framework se poate face în metode diferite, cele mai populare fiind prin Composer sau cURL, care permite înstalarea într-un container Docker, dar această parte nu va fi tratată momentan.

Instrumente și pachete necesare:

 

- Windows:

• XAMPP (recomand folosirea variantei cu PHP 8.1.6, fiind ultimul release stabil) - link download: https://www.apachefriends.org/download.html)
• Composer - link download: https://getcomposer.org/Composer-Setup.exe
  • În cazul în care la sfârșitul instalației comenzile în terminal de tip "composer require <dependență>" nu merg, recomand urmarea tutorialului oficial de pe site-ul de la Oracle (https://docs.oracle.com/en/database/oracle/machine-learning/oml4r/1.5.1/oread/creating-and-modifying-environment-variables-on-windows.html), iar valoare pe care va trebui să o introduceți în path este: "C:\Users\<User-ul vostru>\AppData\Roaming\Composer\vendor\bin".
• Node & NPM - link download: https://nodejs.org/en/download/

 

- Linux (pentru acest tutorial vom folosi Debian) :

• Apache/NGINX web server - se poate instala utilizând "apt install apache2" sau "apt install nginx"

  • sudo apt install -y apache2

     

  • sudo apt install -y nginx

• PHP (recomand versiunea 8.1.6)

  • apt install -y software-properties-common curl apt-transport-https ca-certificates gnupg
    LC_ALL=C.UTF-8 add-apt-repository -y ppa:ondrej/php
    apt update
    apt install -y php8.1 php8.1-{cli,gd,mysql,pdo,mbstring,bcmath,xml,fpm,curl}

• Composer

  • curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer

• MySQL

  • cd /tmp
    wget https://dev.mysql.com/get/mysql-apt-config_0.8.22-1_all.deb
    sudo dpkg -i mysql-apt-config*
    sudo apt update
    sudo apt install -y mysql-server
    mysql_secure_installation

• Node & NPM

  • curl -sL https://deb.nodesource.com/setup_16.x | sudo -E bash -
    sudo apt-get install -y nodejs

     

Odată ce am instalat toate instrumentele necesare, putem continua cu instalarea framework-ului Laravel.

 

Crearea unei noi aplicații Laravel

Pentru a crea o nouă aplicație Laravel va trebui sa instalăm global Laravel Installer. Pentru a face acest lucru vom deschide terminalul (fie acesta Windows CMD, Powershell, Git bash, WSL, etc.) și vom executa comanda:

 

composer global require laravel/installer

 

După terminarea instalării vom fi nevoiți să închidem și să deschidem din nou terminalul folosit, iar de acum vom putea crea aplicații în Laravel folosind una dintre urmatoarele comenzi, în funcție de preferința fiecăruia:

- Instalare clasică:

• laravel new MyApp

   

- Instalare cu Jetstream (folosind Livewire sau Inertia.js) :

• laravel new MyApp --jet

• În acest caz, installer-ul ne va pune să alegem care dintre cele 2 scaffolding-uri pentru frontend dorim să alegem. Cele 2 opțiuni valabile sunt Livewire (care foloseste Javascript & HTML) sau Inertia.js (care folosește Vue.js 3). Pentru persoanele care nu au experiență cu framework-uri legate de frontend (adica de partea vizuală a unui site), recomand folosirea scaffolding-ului Livewire (prima opțiune din instalare).
• Installer-ul va continua cu anumite întrebări, una dintre care este legată de dorința utilizatorului de a permite support-ul pentru echipe (care permite crearea unor team-uri și invitarea utilizatorilor în acestea).
• La sfârșitul instalării vom avea o aplicație care permite utilizatorilor să se înregistreze, să iși reseteze parola, să iși modifice profilul adăugând o poză, iar totodată le permite să sporească securitatea contului, folosind sistemul de 2FA pus la dispoziție de package, dar permite și verificarea ultimelor conexiuni la cont cât și ștergerea acestuia.

 

- Instalare cu Breeze

• laravel new MyApp
  cd MyApp
  composer require laravel/breeze --dev
  php artisan breeze:install

• Instalarea acestei implementari necesită instalarea unei aplicații default Laravel și instalarea implementației Breeze, care va crea automat fișiere și va adăuga un sistem de autentificare similar cu cel folosit de către Laravel Jetstream.

 

Lansarea noii aplicații Laravel

Înainte de a putea porni noua aplicație Laravel, vom fi nevoiți să îndeplinim înca 5 acțiuni în interiorul folder-ului, indiferent de decizia de instalare:

1. Va trebui sa instalam toate dependențele folosind comanda:

   • composer install

2. Odată terminată instalarea dependențelor, vom fi nevoiți să instalăm package-urile folosite prin NPM, folosind comanda:

   • npm install & npm run dev

3. Pentru a putea rula noua aplicație, va trebui să modificam fișierul .env (în cazul în care acesta nu este vizibil, va trebui să intrăm în setări și să afișam fișierele ascunse), iar daca acesta nu exista va trebui să facem o copie la .env.example și să îl redenumim in .env, iar apoi vom adăuga baza noastră de date editând următoarele linii:

   • DB_CONNECTION=mysql
     DB_HOST=127.0.0.1
     DB_PORT=3306
     DB_DATABASE=nume_baza
     DB_USERNAME=nume_user
     DB_PASSWORD=parola

4. Laravel pune la dispoziție developerilor tabele deja create prin sistemul Eloquent, iar pentru a popula baza de date vom executa comanda:

   • php artisan migrate

5. Ajunsi la acest pas, aplicația noastră este gata de a fi pornită, folosind comanda:

   • php artisan serve

 

Dacă până în acest punct nu au fost întâmpinate probleme, vom putea intra în browser și vom putea naviga către http://localhost:8000 iar pagina default de la Laravel va fi vizibila în mod local sau pe web.

 

Pentru acest tutorial au fost folosite comenzi pe care le puteți regăsii pe site-ul oficial de la Laravel Docs: https://laravel.com/docs/9.x