Průvodce pro začátečníky po konzoli Laravel Artisan Console

Artisan je nástroj příkazového řádku, který Laravel používá pro přístup ke svým aplikacím. Poskytuje řadu příkazů, které mohou výrazně usnadnit váš vývojový proces.

Pokud vás tedy zajímá, co to může udělat a jak to začít dělat, toto je průvodce pro vás. Zde je vše, co potřebujete vědět o tom, jak používat konzolu Artisan v Laravelu.

Začínáme

Ve svém terminálu zadejte níže uvedený příkaz do adresáře vaší aplikace Laravel.

$ php seznam řemeslníků

Zobrazí se seznam dostupných příkazů.

Když používáte příkazy, můžete jim předcházet pomocí Pomoc možnost zobrazit jejich dostupné argumenty a možnosti. Na pravé straně terminálu se zobrazí krátký popis toho, co dělají.

$ php artisan - help serve

Spropitné: Stejně jako u většiny akcí příkazového řádku je syntaxe: příkaz [možnosti] [argumenty] 

Dráteník

Tinker je REPL (nebo interaktivní shell), který používá Laravel. „Smyčka čtení-eval-tisk“ (REPL) je programovací prostředí, které přijímá jednotlivé uživatelské vstupy, zpracovává je a vrací výsledek uživateli.

Tinker můžete přirovnat k použití interpretu Pythonu, ale Tinker je pro Laravel vyroben na zakázku.

Toto konkrétní prostředí poskytuje mnoho výhod, jako je snadné spouštění jednoduchých testů v systému bez neustálého psaní souborů.

Poznámka: Pokud používáte Laravel Sail, přidejte plachta příkaz a vaše pokyny budou provedeny v kontejnerech Dockeru vaší aplikace.

$ ./ plachta seznam řemeslníků

Jak nainstalovat Tinker

Ve výchozím nastavení je vaše aplikace Laravel dodávána s aplikací Tinker. Pokud jste jej dříve odinstalovali, můžete jej znovu přidat pomocí hudební skladatel.

$ skladatel vyžaduje laravel / dráteník

Psaní příkazů

Tinker vám umožňuje komunikovat s celou vaší aplikací. Chcete-li začít používat Tinker, zadejte:

$ php řemeslník

Poté vás přivítá drotářská skořápka.

Příbuzný: Jak manipulovat s textem v PHP pomocí těchto 9 funkcí

Tinker má seznam povolených příkazů, který určuje, které příkazy lze spustit v jeho prostředí. Chcete-li tento seznam rozšířit, přejděte na /vendor/laravel/tinker/config adresář, který obsahuje tinker.php.

Tento soubor můžete upravit v preferovaném textovém editoru a přidat tak svůj příkaz.

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

Definování vlastních příkazů

Kromě výchozích řemeslných příkazů můžete vytvářet vlastní příkazy. Při vytváření se příkazy automaticky ukládají do souboru aplikace / konzole / příkazy adresář.

Ve svém novém projektu Laravel neuvidíte /Command adresář. To je normální. Složka se automaticky vytvoří, když definujete nový příkaz. Podívejte se, jak generovat příkazy níže.

Vytváření příkazů

Definujte podpis svého příkazu a popis třídy. V souboru třídy příkazu definujete také jeho argumenty. Vezměte tento příklad:

$ php řemeslník make: příkaz GetDailySales

Níže uvedený soubor se automaticky generuje při spuštění. Logiku příkazu můžete umístit do metody handle, protože se volá při spuštění příkazu.

php 
 jmenný prostor App \ Console \ Commands; 
 použití Illuminate \ Console \ Command; 
 třída GetDailySales rozšiřuje příkaz 
 {
 / ** 
 * název a podpis příkaz konzoly. 
 * 
 * řetězec @var 
 * / 
 chráněný $ signature = 'příkaz: jméno'; 
 / ** 
 * popis příkazu konzoly. 
 * 
 * @var řetězec 
 * / 
 chráněný $ description = 'Popis příkazu'; 
 / ** 
 * Vytvořit novou instanci příkazu. 
 * 
 * @return void 
 * / 
 publicfunction__construct () 
 {
 parent:: __construct (); 
} 
 / ** 
 * Spustit konzolu příkaz. 
 * 
 * @return int 
 * / 
 publicfunctionhandle () 
 {
 return0; 
} 
}  

Příkazy uzavření

Uzavření můžete kontrastovat příkazy, které mají definovat uzávěry trasy namísto použití řadičů. Podobně můžete místo vytváření tříd příkazů (jako jsme to udělali v části „Vytváření příkazů“) použít příkaz uzávěry.

Výhodou je, že budete mít méně souborů ke správě a vaše logika bude snazší přes.

Další informace: Vysoká úroveň vs. Nízkoúrovňové programovací jazyky, vysvětleno

Soubor Kernel.php definuje cesty konzoly k vaší aplikaci. Všechny příkazy uzavírací konzoly můžete v tomto souboru definovat pomocí metody Artisan:: command . Příkaz má dva argumenty: podpis příkazu a uzávěr, ke kterému jej přiřazujete.

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

Závislosti Type-Hintingu

Tipování typu odkazuje na statické definování datového typu, který má funkce vrátit, nebo argumentu by měl převzít. Uzávěry příkazů mohou také typově naznačit závislosti, které potřebujete získat z kontejneru služeb.

Popis uzavření příkazů

Chcete-li přidat popis uzavření příkazu, použijte Metoda purpose () .

  
 Artisan:: command ('text: send {user}', function ($ user) {
 //... 
}) - > účel ('Odeslat SMS text uživateli '); 
 

Úplný seznam příkazů a funkcí můžete zobrazit na stránce Laravel dokumenty .

Další informace Laravel

Laravel má na svém oficiálním webu silnou vývojářskou komunitu a dobře napsanou dokumentaci. To znamená, že vám nikdy nedojde místo, kde najdete pomoc, když uvíznete.

Pokračujte v procvičování pomocí konzoly řemeslníka a uvědomíte si, jak výkonné a časově úsporné mohou být příkazy. Laravel však není jen konzole Artisan.

Laravel 8 představuje řadu nových funkcí, které vám pomohou vylepšit hru pro webový vývojář.

8 Nové výkonné funkce pro vývoj webu v Laravelu 8

Rámec PHP Laravel je nyní ve verzi 8. Zde je pohled na nové funkce pro vývoj webu, které můžete očekávat.

Číst dále

O společnosti Autor