En nybörjarguide till Laravel Artisan Console

Artisan är kommandoradsverktyget som Laravel använder för att komma åt sina applikationer. Det ger ett antal kommandon som i hög grad kan underlätta din utvecklingsprocess.

Så om du undrar vad den kan göra och hur du kommer igång med det är det här guiden för dig. Här är allt du behöver veta om hur du använder Artisan-konsolen i Laravel.

Komma igång

Skriv kommandot nedan i din terminal i katalogen för din Laravel-applikation.

$ php hantverkslista

Den visar listan över tillgängliga kommandon.

När du använder kommandon kan du föregå dem med hjälp alternativ för att visa tillgängliga argument och alternativ. Terminalen visar en kort beskrivning av vad de gör på höger sida.

$ php hantverkare - hjälp servera

Dricks: Som med de flesta kommandoradsåtgärder är syntaxen: kommando [alternativ] [argument] 

Knåpa

Tinker är REPL (eller det interaktiva skalet) som Laravel använder. En "read-eval-print loop" (REPL) är en programmeringsmiljö som tar inmatningar från en användare, bearbetar dem och returnerar ett resultat till användaren.

Du kan jämföra Tinker med att använda Python-tolk, men Tinker är skräddarsydd för Laravel.

Denna speciella miljö ger många fördelar, som att enkelt köra enkla tester på systemet utan att ständigt skriva filer.

Notera: Om du använder Laravel Sail, lägg till segla kommandot och dina instruktioner kommer att köras i Docker-behållarna i din applikation.

$ ./sail artisan list

Hur man installerar Tinker

Som standard kommer din Laravel-app med Tinker. Om du tidigare har avinstallerat det kan du lägga till det igen via kompositör.

$ kompositör kräver laravel / tinker

Skrivkommandon

Tinker låter dig interagera med hela din applikation. För att börja använda Tinker, skriv:

$ php hantverkare

Du hälsas sedan med tinker-skalet.

Relaterad: Hur man hanterar text i PHP med dessa 9 funktioner

Tinker har en kommandotillåtningslista som avgör vilka kommandon som kan köras i dess skal. För att utöka listan kan du gå till /vendor/laravel/tinker/config katalog som innehåller tinker.php.

Du kan redigera den här filen i din textredigerare för att lägga till ditt kommando.

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

Definiera dina egna kommandon

Förutom standardhantverkskommandona kan du skapa egna kommandon. Vid skapandet lagras kommandona automatiskt i app / konsol / kommandon katalog.

I ditt nya Laravel-projekt ser du inte /Command katalog. Det här är normalt. Mappen skapas automatiskt när du definierar ett nytt kommando. Se hur du genererar kommandon nedan.

Skapa kommandon

Definiera ditt kommandos signatur och en beskrivning av klassen. I kommandot klassfil definierar du dess argument. Ta detta exempel:

$ php artisan make: kommando GetDailySales

Filen nedan genereras automatiskt vid körning. Du kan placera din kommandologik i handtagsmetoden eftersom den kallas när kommandot körs.

php 
 namespace App \ Console \ Commands; 
 använd Illuminate \ Console \ Command; 
 class GetDailySales extends Command 
 {
 / ** 
 * Namnet och underskrift av konsolkommandot. 
 * 
 * @var sträng 
 * / 
 skyddad $ signatur = 'kommando: namn'; 
 / ** 
 * konsolkommandobeskrivning. 
 * 
 * @var sträng 
 * / 
 skyddad $ beskrivning = 'Kommandobeskrivning'; 
 / ** 
 * Skapa en ny kommandoinstans. 
 * 
 * @return ogiltigt 
 * / 
 publicfunction__construct () 
 {
 parent: __construct (); 
} 
 / ** 
 * Kör konsolen kommando. 
 * 
 * @return int 
 * / 
 publicfunctionhandle () 
 {
 return0; 
} 
}  

Stängningskommandon

Du kan kontrastera stängning kommandon för att definiera ruttstängningar istället för att använda styrenheter. På samma sätt kan du bara använda kommandot istället för att skapa kommandoklasser (som vi gjorde i avsnittet "Skapa kommandon") stängningar.

Fördelen här är att du kommer att ha färre filer att hantera och din logik är lättare att tumma genom.

Läs mer: Högnivå vs. Programmeringsspråk på låg nivå, förklarade

Filen Kernel.php definierar konsolvägar till din applikation. Du kan definiera alla dina kommandon för stängningskonsolen med Artisan:: kommando -metoden i den här filen. Kommandot tar in två argument: kommandosignaturen och stängningen du tilldelar den till.

  Artisan:: command ('report: get {day}', function ($ day) {
 $ this-> info ("Genererar rapport för: {$ day}! "); 
});  

Typ-hinting Dependences

Typ-hinting refererar till att definiera den datatyp som en funktion ska returnera eller ett argument statiskt borde ta på sig. Kommandostängningar kan också ange vilka beroenden du behöver för att få från servicebehållaren.

Beskrivning av stängningar av kommandon

För att lägga till en beskrivning till en kommandostängning, använd syfte () -metoden.

  
 Artisan:: command ('text: send {user}', function ($ user) {
 //... 
}) - > syfte ('Skicka sms-text till en användare '); 
 

Du kan se en fullständig lista med kommandon och funktioner på Laravels dokument .

Läs mer Laravel

Laravel har en stark utvecklargemenskap och välskriven dokumentation från sin officiella webbplats. Det betyder att du aldrig får slut på platser för att hitta hjälp när du fastnar.

Fortsätt att öva med hantverkekonsolen och du inser hur kraftfulla och tidsbesparande kommandona kan vara. Laravel är dock inte bara Artisan-konsolen.

Laravel 8 introducerar en mängd nya funktioner för att förbättra ditt webbutvecklingsspel.

8 Kraftfulla nya webbutvecklingsfunktioner i Laravel 8

PHP-ramverk Laravel finns nu i version 8. Här är en titt på de nya webbutvecklingsfunktionerna du kan förvänta dig.

Läs Nästa

Om The Författare