En nybegynnerveiledning til Laravel Artisan Console

Artisan er kommandolinjeverktøyet som Laravel bruker for å få tilgang til programmene. Det gir en rekke kommandoer som kan lette utviklingsprosessen din.

Så hvis du lurer på hva den kan gjøre og hvordan du kommer i gang med det, er dette guiden for deg. Her er alt du trenger å vite om hvordan du bruker Artisan-konsollen i Laravel.

Starter

Skriv inn kommandoen i terminalen din i katalogen til Laravel-applikasjonen.

$ php håndverkerliste

Den viser listen over tilgjengelige kommandoer.

Når du bruker kommandoer, kan du gå foran dem med hjelp alternativet for å vise tilgjengelige argumenter og alternativer. Terminalen viser en kort beskrivelse av hva de gjør på høyre side.

$ php håndverker - hjelp til servering

Tips: Som med de fleste kommandolinjehandlinger er syntaksen: kommando [alternativer] [argumenter] 

Tinker

Tinker er REPL (eller interaktivt skall) som Laravel bruker. En "read-eval-print loop" (REPL) er et programmeringsmiljø som tar enkeltbrukerinnganger, behandler dem og returnerer et resultat til brukeren.

Du kan sammenligne Tinker med å bruke Python-tolk, men Tinker er skreddersydd for Laravel.

Dette spesielle miljøet gir mange fordeler, som å kjøre enkle tester på systemet uten å skrive filer hele tiden.

Merk: Hvis du bruker Laravel Sail, kan du legge til seile kommandoen og instruksjonene dine blir utført i Docker-beholderne i applikasjonen din.

$ ./seil håndverksliste

Hvordan installere Tinker

Som standard kommer Laravel-appen din med Tinker. Hvis du tidligere har avinstallert det, kan du legge det til igjen via komponist.

$ komponist krever laravel / tinker

Skrive kommandoer

Tinker lar deg samhandle med hele applikasjonen. For å begynne å bruke Tinker, skriv inn:

$ php håndverker tinker

Du blir deretter møtt med tinker-skallet.

I slekt: Hvordan håndtere tekst i PHP med disse 9 funksjonene

Tinker har en kommando-tillatelsesliste som bestemmer hvilke kommandoer som kan kjøres i skallet. For å utvide denne listen, kan du gå til /vendor/laravel/tinker/config katalog som inneholder tinker.php.

Du kan redigere denne filen i ønsket teksteditor for å legge til kommandoen.

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

Definere dine egne kommandoer

Bortsett fra standard håndverkekommandoer, kan du opprette dine egne kommandoer. Når du oppretter, lagres kommandoene automatisk i app / konsoll / kommandoer katalog.

I det nye Laravel-prosjektet ditt ser du ikke /Command katalog. Dette er normalt. Mappen opprettes automatisk når du definerer en ny kommando. Se hvordan du genererer kommandoer nedenfor.

Opprette kommandoer

Definer kommandosignaturen og en beskrivelse av klassen. I kommandofilens fil vil du også definere argumentene. Ta dette eksemplet:

$ php artisan make: kommando GetDailySales

Filen nedenfor genereres automatisk ved kjøring. Du kan plassere kommandologikken din i håndteringsmetoden siden den heter når kommandoen kjøres.

php 
 namespace App \ Console \ Commands; 
 bruk Illuminate \ Console \ Command; 
 klasse GetDailySales utvider kommando 
 {
 / ** 
 * Navnet og signatur av konsollkommandoen. 
 * 
 * @var streng 
 * / 
 protected $ signature = 'command: name'; 
 / ** 
 * The beskrivelse av konsollkommandoen. 
 * 
 * @var streng 
 * / 
 beskyttet $ beskrivelse = 'Kommandobeskrivelse'; 
 / ** 
 * Opprett en ny kommandoinstans. 
 * 
 * @return ugyldig 
 * / 
 publicfunction__construct () 
 {
 foreldre:: __construct (); 
} 
 / ** 
 * Utfør konsollen kommando. 
 * 
 * @return int 
 * / 
 publicfunctionhandle () 
 {
 return0; 
} 
}  

Lukkekommandoer

Du kan kontrastere lukking kommandoer for å ha definert rutestenging i stedet for å bruke kontrollere. På samme måte, i stedet for å lage kommandoklasser (som vi gjorde i delen "Opprette kommandoer"), kan du bare bruke kommandoen nedleggelser.

Fordelen her er at du kommer til å ha færre filer å administrere, og logikken din er lettere å tommelfinger gjennom.

Les mer: Høyt nivå vs. Programmeringsspråk på lavt nivå, forklart

Filen Kernel.php definerer konsollruter til applikasjonen din. Du kan definere alle lukkekonsollkommandoene dine med Artisan:: -kommandoen -metoden i denne filen. Kommandoen tar i to argumenter: kommandosignaturen og lukkingen du tilordner den til.

  Artisan:: command ('report: get {day}', function ($ day) {
 $ this-> info ("Genererer rapport for: {$ day}! "); 
});  

Type-Hinting Avhengigheter

Type-hinting refererer til statisk definering av datatypen en funksjon skal returnere eller et argument burde ta på seg. Kommandolukking kan også skrive tips om avhengighetene du trenger for å få fra servicecontaineren.

Beskrive kommandolukkinger

Hvis du vil legge til en beskrivelse i en kommandolukking, bruker du formål () -metoden.

  
 Artisan:: command ('text: send {user}', function ($ user) {
 //... 
}) - > formål ('Send sms-tekst til en bruker '); 
 

Du kan se en fullstendig liste over kommandoer og funksjoner på Laravels dokumenter .

Lær mer Laravel

Laravel har et sterkt utviklersamfunn og velskrevet dokumentasjon fra sitt offisielle nettsted. Dette betyr at du aldri vil gå tom for steder for å finne hjelp når du blir sittende fast.

Fortsett å øve med håndverkskonsollen, og du vil innse hvor kraftige og tidsbesparende kommandoene kan være. Laravel er ikke bare håndverkskonsollen.

Laravel 8 introduserer en rekke nye funksjoner for å forbedre nettutviklingsspillet ditt.

8 Kraftige nye webutviklingsfunksjoner i Laravel 8

PHP-rammeverk Laravel er nå i versjon 8. Her ser du på de nye webutviklingsfunksjonene du kan forvente.

Les Neste

Om The Forfatter