Una guida per principianti alla console artigianale Laravel

Artisan è lo strumento della riga di comando che Laravel utilizza per accedere alle sue applicazioni. Fornisce una serie di comandi che possono facilitare notevolmente il processo di sviluppo.

Quindi, se ti stai chiedendo cosa può fare e come iniziare a farlo, questa è la guida che fa per te. Ecco tutto ciò che devi sapere su come utilizzare la console Artisan in Laravel.

Iniziare

Nel tuo terminale, digita il comando seguente nella directory della tua applicazione Laravel.

$ php elenco artigiano

Mostrerà l'elenco dei comandi disponibili.

Quando si utilizzano i comandi, è possibile farli precedere da Aiuto opzione per mostrare gli argomenti e le opzioni disponibili. Il terminale mostrerà una breve descrizione di ciò che fanno sul lato destro.

$ php artisan --help serve

Mancia: Come con la maggior parte delle azioni della riga di comando, la sintassi è: comando [opzioni] [argomenti] 

Tinker

Tinker è la REPL (o shell interattiva) utilizzata da Laravel. Un "ciclo di lettura-valutazione-stampa" (REPL) è un ambiente di programmazione che accetta input di un singolo utente, li elabora e restituisce un risultato all'utente.

Puoi confrontare Tinker con l'utilizzo dell'interprete Python, ma Tinker è fatto su misura per Laravel.

Questo particolare ambiente offre molti vantaggi, come eseguire facilmente semplici test sul sistema senza scrivere costantemente file.

Nota: Se stai usando Laravel Sail, aggiungi il file vela comando e le tue istruzioni verranno eseguite all'interno dei contenitori Docker della tua applicazione.

Lista artigiani $ ./sail

Come installare Tinker

Per impostazione predefinita, la tua app Laravel viene fornita con Tinker. Se l'hai precedentemente disinstallato, puoi aggiungerlo di nuovo tramite compositore.

$ composer richiede laravel / tinker

Comandi di digitazione

Tinker ti consente di interagire con l'intera applicazione. Per iniziare a utilizzare Tinker, digita:

$ php artisan tinker

Sei quindi accolto con il guscio tinker.

Relazionato: Come manipolare il testo in PHP con queste 9 funzioni

Tinker ha un elenco di comandi consentiti che determina quali comandi possono essere eseguiti nella sua shell. Per espandere questo elenco, puoi andare al /vendor/laravel/tinker/config directory che contiene tinker.php.

Puoi modificare questo file nel tuo editor di testo preferito per aggiungere il tuo comando.

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

Definizione dei propri comandi

Oltre ai comandi artisan predefiniti, puoi creare i tuoi comandi. Al momento della creazione, i comandi vengono automaticamente memorizzati nel file app / Console / Comandi directory.

Nel tuo nuovo progetto Laravel, non vedrai il file /Command directory. E 'normale. La cartella viene creata automaticamente quando si definisce un nuovo comando. Guarda come generare comandi di seguito.

Creazione di comandi

Definisci la firma del tuo comando e una descrizione della classe. Nel file di classe del comando, definirai anche i suoi argomenti. Prendi questo esempio:

$ php artisan make: comando GetDailySales

Il file seguente viene generato automaticamente al momento dell'esecuzione. È possibile inserire la logica del comando nel metodo handle poiché viene chiamato quando il comando viene eseguito.

php 
 namespace App \ Console \ Commands; 
 usa Illuminate \ Console \ Command; 
 class GetDailySales estende Command 
 {
 / ** 
 * Il nome e firma di il comando della console. 
 * 
 * @var string 
 * / 
 protected $ signature = 'command: name'; 
 / ** 
 * Il descrizione del comando da console. 
 * 
 * @var stringa 
 * / 
 protected $ description = 'Descrizione comando'; 
 / ** 
 * Crea una nuova istanza di comando. 
 * 
 * @return void 
 * / 
 publicfunction__construct () 
 {
 parent:: __construct (); 
} 
 / ** 
 * Esegui la console comando. 
 * 
 * @return int 
 * / 
 publicfunctionhandle () 
 {
 return0; 
} 
}  

Comandi di chiusura

Puoi contrastare la chiusura comandi per definire le chiusure delle rotte invece di utilizzare i controller. Allo stesso modo, invece di creare classi di comando (come abbiamo fatto nella sezione "Creazione di comandi"), puoi semplicemente usare command chiusure.

Il vantaggio qui è che avrai meno file da gestire e la tua logica sarà più facile da sfogliare attraverso.

Ulteriori informazioni: Alto livello vs. Linguaggi di programmazione di basso livello, spiegati

Il file Kernel.php definisce le rotte della console verso la tua applicazione. Puoi definire tutti i comandi della console di chiusura con il metodo Artisan:: command in questo file. Il comando accetta due argomenti: la firma del comando e la chiusura a cui lo stai assegnando.

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

Dipendenze suggerimento tipo

Il suggerimento tipo si riferisce alla definizione statica del tipo di dati che una funzione dovrebbe restituire o di un argomento dovrebbe assumere. Le chiusure dei comandi possono anche suggerire il tipo delle dipendenze che devi ottenere dal contenitore dei servizi.

Descrivere le chiusure dei comandi

Per aggiungere una descrizione alla chiusura di un comando, usa il metodo scopo () .

  
 Artisan:: command ('text: send {user}', function ($ user) {
 //... 
}) - > scopo ('Invia testo sms a un utente '); 
 

Puoi visualizzare un elenco completo di comandi e funzionalità su Laravel documenti .

Ulteriori informazioni Laravel

Laravel ha una forte comunità di sviluppatori e una documentazione ben scritta dal suo sito ufficiale. Ciò significa che non sarai mai a corto di posti per trovare aiuto quando rimani bloccato.

Continua a esercitarti con la console artisan e ti renderai conto di quanto possano essere potenti e veloci i comandi. Laravel non è solo la console Artisan, però.

Laravel 8 introduce una serie di nuove funzionalità per migliorare il tuo gioco di sviluppo web.

8 Nuove potenti funzionalità di sviluppo web in Laravel 8

Framework PHP Laravel è ora alla versione 8. Ecco uno sguardo alle nuove funzioni di sviluppo web che puoi aspettarti.

Leggi avanti

Informazioni su Autore