En begyndervejledning til Laravel Artisan Console

Artisan er kommandolinjeværktøjet, som Laravel bruger til at få adgang til dets applikationer. Det giver et antal kommandoer, som i høj grad kan lette din udviklingsproces.

Så hvis du spekulerer på, hvad den kan gøre, og hvordan du kommer i gang med at gøre det, er dette vejledningen for dig. Her er alt hvad du behøver at vide om, hvordan du bruger Artisan-konsollen i Laravel.

Kom godt i gang

Skriv kommandoen i din terminal i mappen til din Laravel-applikation.

$ php håndværkerliste

Det viser listen over tilgængelige kommandoer.

Når du bruger kommandoer, kan du gå foran dem med Hjælp mulighed for at vise deres tilgængelige argumenter og muligheder. Terminalen viser en kort beskrivelse af, hvad de gør på højre side.

$ php håndværker - hjælp til servering

Tip: Som med de fleste kommandolinjeaktioner er syntaksen: kommando [optioner] [argumenter] 

Tinker

Tinker er den REPL (eller den interaktive shell), som Laravel bruger. En "read-eval-print loop" (REPL) er et programmeringsmiljø, der tager enkeltbrugerindgange, behandler dem og returnerer et resultat til brugeren.

Du kan sammenligne Tinker med at bruge Python-tolk, men Tinker er skræddersyet til Laravel.

Dette særlige miljø giver mange fordele, som f.eks. At køre enkle tests på systemet uden konstant at skrive filer.

Bemærk: Hvis du bruger Laravel Sail, skal du tilføje sejle kommando, og dine instruktioner udføres i Docker-containerne i din applikation.

$ ./sejl håndværksliste

Sådan installeres Tinker

Som standard leveres din Laravel-app med Tinker. Hvis du tidligere har afinstalleret det, kan du tilføje det igen via komponist.

$ komponist kræver laravel / tinker

Skrive kommandoer

Tinker giver dig mulighed for at interagere med hele din applikation. For at begynde at bruge Tinker skal du skrive:

$ php håndværker tinker

Derefter bliver du mødt med tinker shell.

Relaterede: Sådan manipuleres tekst i PHP med disse 9 funktioner

Tinker har en kommando-tilladelsesliste, der bestemmer, hvilke kommandoer der kan køres i sin shell. For at udvide denne liste kan du gå til /vendor/laravel/tinker/config katalog, der indeholder tinker.php.

Du kan redigere denne fil i din foretrukne teksteditor for at tilføje din kommando.

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

Definere dine egne kommandoer

Bortset fra standardhåndværkerkommandoer kan du oprette dine egne kommandoer. Ved oprettelsen gemmes kommandoerne automatisk i app / konsol / kommandoer vejviser.

I dit nye Laravel-projekt kan du ikke se /Command vejviser. Dette er normalt. Mappen oprettes automatisk, når du definerer en ny kommando. Se hvordan du genererer kommandoer nedenfor.

Oprettelse af kommandoer

Definer din kommandos signatur og en beskrivelse af klassen. I kommandens klassefil definerer du også dens argumenter. Tag dette eksempel:

$ php artisan make: kommando GetDailySales

Filen nedenfor genereres automatisk ved udførelse. Du kan placere din kommandologik i håndteringsmetoden, da den kaldes, når kommandoen udføres.

php 
 namespace App \ Console \ Commands; 
 brug Illuminate \ Console \ Command; 
 klasse GetDailySales udvider kommando 
 {
 / ** 
 * Navnet og underskrift af konsolkommandoen. 
 * 
 * @var streng 
 * / 
 beskyttet $ signatur = 'kommando: navn'; 
 / ** 
 * beskrivelse af konsolkommando. 
 * 
 * @var streng 
 * / 
 beskyttet $ beskrivelse = 'Kommandobeskrivelse'; 
 / ** 
 * Opret en ny kommandoinstans. 
 * 
 * @return ugyldig 
 * / 
 publicfunction__construct () 
 {
 overordnet:: __construct (); 
} 
 / ** 
 * Udfør konsollen kommando. 
 * 
 * @retur int 
 * / 
 publicfunctionhandle () 
 {
 return0; 
} 
}  

Lukningskommandoer

Du kan kontrastere lukning kommandoer til at have defineret rutelukninger i stedet for at bruge controllere. På samme måde kan du bare bruge kommando i stedet for at oprette kommandoklasser (som vi gjorde i afsnittet "Oprettelse af kommandoer") lukninger.

Fordelen her er, at du får færre filer til at administrere, og din logik er lettere at tommelfinger igennem.

Læs mere: Højt niveau vs. Programmeringssprog på lavt niveau, forklaret

Filen Kernel.php definerer konsolruter til din applikation. Du kan definere alle dine lukningskonsolkommandoer med metoden Artisan:: command i denne fil. Kommandoen indeholder to argumenter: kommandosignaturen og lukningen, du tildeler den til.

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

Type-Hinting Dependencies

Type-hinting refererer til statisk definition af den datatype, en funktion skal returnere eller et argument skulle tage på. Kommandolukninger kan også skrive-tip de afhængigheder, du har brug for at få fra servicecontaineren.

Beskrivelse af kommandolukninger

For at føje en beskrivelse til en kommandolukning, brug formål () metode.

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

Du kan se en komplet liste over kommandoer og funktioner på Laravels dokumenter .

Lær mere Laravel

Laravel har et stærkt udviklerfællesskab og velskrevet dokumentation fra sit officielle websted. Dette betyder, at du aldrig løber tør for steder for at finde hjælp, når du sidder fast.

Fortsæt med at øve dig med håndværkskonsollen, og du vil indse, hvor kraftige og tidsbesparende kommandoerne kan være. Laravel er dog ikke kun håndværkerkonsollen.

Laravel 8 introducerer en lang række nye funktioner til dit webudviklingsspil.

8 Kraftige nye webudviklingsfunktioner i Laravel 8

PHP-ramme Laravel er nu i version 8. Her er et kig på de nye webudviklingsfunktioner, du kan forvente.

Læs Næste

Om The Forfatter