Sprievodca pre začiatočníkov po konzole Laravel Artisan Console

Artisan je nástroj príkazového riadku, ktorý Laravel používa na prístup k svojim aplikáciám. Poskytuje množstvo príkazov, ktoré môžu výrazne uľahčiť váš vývojový proces.

Ak vás teda zaujíma, čo to môže urobiť a ako to začať robiť, toto je sprievodca pre vás. Tu je všetko, čo potrebujete vedieť o tom, ako používať konzolu Artisan v Laravelu.

Začíname

Vo svojom termináli zadajte nasledujúci príkaz do adresára vašej aplikácie Laravel.

$ php zoznam remeselníkov

Zobrazí sa zoznam dostupných príkazov.

Pri používaní príkazov im môžete predchádzať Pomoc možnosť zobraziť svoje dostupné argumenty a možnosti. Na pravej strane terminálu sa zobrazí krátky popis toho, čo robia.

$ php artisan - pomôžte slúžiť

Tip: Ako u väčšiny akcií príkazového riadku, aj tu je syntax: príkaz [možnosti] [argumenty] 

Drotár

Tinker je REPL (alebo interaktívny shell), ktorý používa Laravel. „Slučka read-eval-print“ (REPL) je programovacie prostredie, ktoré prijíma jednotlivé užívateľské vstupy, spracováva ich a vráti užívateľovi výsledok.

Tinker môžete porovnať s použitím tlmočníka Pythonu, ale Tinker je vyrobený špeciálne pre Laravel.

Toto konkrétne prostredie poskytuje mnoho výhod, napríklad ľahké vykonávanie jednoduchých testov v systéme bez neustáleho zápisu súborov.

Poznámka: Ak používate Laravel Sail, pridajte vyplávať príkaz a vaše pokyny sa vykonajú v kontajneroch Docker vašej aplikácie.

Zoznam remeselníkov $ ./ plachta

Ako nainštalovať Tinker

Aplikácia Laravel je predvolene dodávaná s programom Tinker. Ak ste ho predtým odinštalovali, môžete ho znova pridať pomocou skladateľ.

$ skladateľ vyžaduje laravel / drotárstvo

Písanie príkazov

Tinker vám umožňuje komunikovať s celou vašou aplikáciou. Ak chcete začať používať program Tinker, zadajte:

remeselník $ php

Potom vás privítajú s drotárom.

Súvisiace: Ako manipulovať s textom v PHP pomocou týchto 9 funkcií

Tinker má zoznam povolených príkazov, ktorý určuje, ktoré príkazy je možné spustiť v jeho prostredí. Ak chcete rozšíriť tento zoznam, môžete prejsť na stránku /vendor/laravel/tinker/config adresár, ktorý obsahuje tinker.php.

Tento súbor môžete upraviť v preferovanom textovom editore a pridať tak svoj príkaz.

'commands' => [
// App \ Console \ Commands \ ExampleCommand:: class,
],

Definovanie vlastných príkazov

Okrem predvolených remeselných príkazov môžete vytvárať aj svoje vlastné príkazy. Pri vytváraní sa príkazy automaticky ukladajú do priečinka aplikácia / konzola / príkazy adresár.

Vo svojom novom projekte Laravel neuvidíte /Command adresár. Toto je normálne. Priečinok sa vytvorí automaticky, keď definujete nový príkaz. Nižšie nájdete informácie o tom, ako generovať príkazy.

Vytváranie príkazov

Definujte podpis svojho príkazu a popis triedy. V súbore triedy príkazu definujete aj jeho argumenty. Vezmite si tento príklad:

$ php artisan make: príkaz GetDailySales

Pri spustení sa súbor generuje automaticky. Svoju logiku príkazov môžete vložiť do metódy handle, pretože sa volá pri spustení príkazu.

php 
 namespace App \ Console \ Commands; 
 použitie Illuminate \ Console \ Command; 
 trieda GetDailySales rozširuje príkaz 
 {
 / ** 
 * názov a podpis príkaz konzoly. 
 * 
 * reťazec @var 
 * / 
 chránený $ signature = 'príkaz: meno'; 
 / ** 
 * popis príkazu konzoly. 
 * 
 * @var reťazec 
 * / 
 chránený $ description = 'Popis príkazu'; 
 / ** 
 * Vytvorte novú inštanciu príkazu. 
 * 
 * @return void 
 * / 
 publicfunction__construct () 
 {
 parent:: __construct (); 
} 
 / ** 
 * vykonať konzolu príkaz. 
 * 
 * @return int 
 * / 
 publicfunctionhandle () 
 {
 return0; 
} 
}  

Príkazy na uzavretie

Uzavretie môžete kontrastovať príkazy na definovanie uzávierok trás namiesto použitia radičov. Podobne môžete namiesto vytvárania príkazových tried (ako sme to robili v sekcii „Vytváranie príkazov“) použiť iba príkaz uzávierky.

Výhodou je, že budete mať menej súborov na správu a vaša logika bude ľahšie ovládateľná cez.

Prečítajte si viac: Na vysokej úrovni vs. Vysvetlenie programovacích jazykov na nízkej úrovni

Súbor Kernel.php definuje trasy konzoly k vašej aplikácii. Všetky príkazy vašej zatváracej konzoly môžete v tomto súbore definovať pomocou metódy Artisan:: command . Príkaz má dva argumenty: podpis príkazu a záver, ku ktorému ho priraďujete.

  Artisan:: command ('report: get {day}', function ($ day) {
 $ this-> info ("Generuje sa report pre: {$ day}! "); 
});  

Závislosti pri tipovaní typu

Tipovanie pomocou typu označuje statické definovanie dátového typu, ktorý by mala funkcia vrátiť, alebo argumentu by sa mali ujať. Uzavretia príkazov môžu tiež naznačiť závislosti, ktoré musíte získať z kontajnera služieb.

Popis zatvorenia príkazu

Ak chcete pridať popis ukončenia príkazu, použite metóda purpose () .

  
 Artisan:: command ('text: send {user}', function ($ user) {
 //... 
}) - > účel ('Odoslať textovú správu SMS používateľovi '); 
 

Celý zoznam príkazov a funkcií si môžete pozrieť na stránke Laravel dokumenty .

Viac informácií Laravel

Laravel má silnú komunitu vývojárov a dobre napísanú dokumentáciu zo svojich oficiálnych stránok. To znamená, že vám nikdy nedôjde miesto, kde nájdete pomoc, keď uviaznete.

Pokračujte v cvičení s remeselníckou konzolou a uvedomíte si, aké výkonné a časovo úsporné môžu byť príkazy. Laravel však nie je iba konzola Artisan.

Laravel 8 predstavuje množstvo nových funkcií pre vylepšenie vašej hry pre webový vývojár.

8 Nové výkonné funkcie pre vývoj webových aplikácií v Laravel 8

Rámec PHP Laravel je teraz vo verzii 8. Tu je prehľad nových funkcií vývoja webu, ktoré môžete očakávať.

Prečítajte si ďalšie

O spoločnosti Autor