Przewodnik dla początkujących po konsoli Laravel Artisan

Artisan to narzędzie wiersza poleceń, którego Laravel używa do uzyskiwania dostępu do swoich aplikacji. Udostępnia szereg poleceń, które mogą znacznie ułatwić proces programowania.

Jeśli więc zastanawiasz się, co może zrobić i jak zacząć to robić, oto przewodnik dla Ciebie. Oto wszystko, co musisz wiedzieć, jak korzystać z konsoli Artisan w Laravel.

Pierwsze kroki

W terminalu wpisz poniższe polecenie w katalogu swojej aplikacji Laravel.

Lista rzemieślników $ php

Wyświetli listę dostępnych poleceń.

Korzystając z poleceń, można poprzedzić je rozszerzeniem Wsparcie możliwość pokazania dostępnych argumentów i opcji. Terminal wyświetli krótki opis tego, co robią po prawej stronie.

$ php artisan --help służyć

Wskazówka: Podobnie jak w przypadku większości akcji wiersza poleceń, składnia jest następująca: polecenie [opcje] [argumenty] 

Majstrować

Tinker to REPL (lub interaktywna powłoka), której używa Laravel. „Pętla odczytu, oceny i wydruku” (REPL) to środowisko programistyczne, które pobiera dane wejściowe od pojedynczego użytkownika, przetwarza je i zwraca użytkownikowi wynik.

Możesz porównać Tinkera do używania interpretera Pythona, ale Tinker jest dostosowany do Laravel.

To szczególne środowisko zapewnia wiele korzyści, takich jak łatwe uruchamianie prostych testów w systemie bez ciągłego zapisywania plików.

Uwaga: Jeśli używasz Laravel Sail, dodaj rozszerzenie żagiel polecenie, a Twoje instrukcje zostaną wykonane w kontenerach Docker aplikacji.

$ ./sail lista rzemieślników

Jak zainstalować Tinker

Domyślnie Twoja aplikacja Laravel jest dostarczana z Tinkerem. Jeśli wcześniej go odinstalowałeś, możesz dodać go ponownie za pośrednictwem kompozytor.

$ composer wymaga laravel / tinker

Wpisywanie poleceń

Tinker umożliwia interakcję z całą aplikacją. Aby rozpocząć korzystanie z Tinkera, wpisz:

$ php rzemieślnik majstrować

Następnie wita cię skorupa majsterkowicza.

Związane z: Jak manipulować tekstem w PHP za pomocą tych 9 funkcji

Tinker ma listę dozwolonych poleceń, która określa, które polecenia mogą być uruchamiane w jego powłoce. Aby rozwinąć tę listę, możesz przejść do /vendor/laravel/tinker/config katalog, który zawiera tinker.php.

Możesz edytować ten plik w preferowanym edytorze tekstu, aby dodać polecenie.

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

Definiowanie własnych poleceń

Oprócz domyślnych poleceń rzemieślniczych możesz tworzyć własne polecenia. Podczas tworzenia polecenia są automatycznie zapisywane w pliku app / Console / Commands informator.

W swoim nowym projekcie Laravel nie zobaczysz /Command informator. To normalne. Folder jest tworzony automatycznie po zdefiniowaniu nowego polecenia. Zobacz, jak generować polecenia poniżej.

Tworzenie poleceń

Zdefiniuj podpis swojego polecenia i opis klasy. W pliku klasy polecenia zdefiniujesz również jego argumenty. Weźmy ten przykład:

$ php rzemieślnik make: polecenie GetDailySales

Poniższy plik jest generowany automatycznie podczas wykonywania. Możesz umieścić logikę poleceń w metodzie handle, ponieważ jest ona wywoływana podczas wykonywania polecenia.

php 
 przestrzeń nazw App \ Console \ Commands; 
 użyj Illuminate \ Console \ Command; 
 klasa GetDailySales rozszerza polecenie 
 {
 / ** 
 * Nazwa i podpis polecenie konsoli. 
 * 
 * @var string 
 * / 
 protected $ signature = 'command: name'; 
 / ** 
 * opis polecenia konsoli. 
 * 
 * @var string 
 * / 
 protected $ description = 'Command description'; 
 / ** 
 * Utwórz nową instancję polecenia. 
 * 
 * @return void 
 * / 
 publicfunction__construct () 
 {
 parent:: __construct (); 
} 
 / ** 
 * Uruchom konsolę polecenie. 
 * 
 * @return int 
 * / 
 publicfunctionhandle () 
 {
 return0; 
} 
}  

Polecenia zamykające

Możesz kontrastować z zamknięciem polecenia do zdefiniowania zamknięć tras zamiast używania kontrolerów. Podobnie, zamiast tworzyć klasy poleceń (tak jak zrobiliśmy to w sekcji „Tworzenie poleceń”), możesz po prostu użyć polecenia domknięcia.

Zaletą jest to, że będziesz mieć mniej plików do zarządzania, a logika będzie łatwiejsza do przez.

Więcej informacji: Wysoki poziom vs. Objaśnienie języków programowania niskiego poziomu

Plik Kernel.php definiuje trasy konsoli do aplikacji. Możesz zdefiniować wszystkie polecenia konsoli zamykania za pomocą metody Artisan:: command w tym pliku. Polecenie przyjmuje dwa argumenty: sygnaturę polecenia i zamknięcie, do którego je przypisujesz.

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

Zależności wskazujące na typ

Podpowiedzi do typu odnoszą się do statycznego definiowania typu danych, które funkcja powinna zwrócić lub argumentu powinien przyjąć. Zamknięcia poleceń mogą również wskazywać na zależności, które należy pobrać z kontenera usługi.

Opisywanie zamknięć poleceń

Aby dodać opis do zamknięcia polecenia, użyj Metoda goal () .

  
 Artisan:: command ('text: send {user}', function ($ user) {
 //... 
}) - > cel ('Wyślij SMS-a do użytkownika '); 
 

Możesz wyświetlić pełną listę poleceń i funkcji na Laravel dokumenty .

Dowiedz się więcej Laravel

Laravel ma silną społeczność programistów i dobrze napisaną dokumentację ze swojej oficjalnej strony. Oznacza to, że nigdy nie zabraknie Ci miejsc, w których możesz znaleźć pomoc, gdy utkniesz.

Kontynuuj ćwiczenie z konsolą rzemieślniczą, a zdasz sobie sprawę, jak potężne i oszczędzające czas mogą być polecenia. Laravel to nie tylko konsola Artisan.

Laravel 8 wprowadza szereg nowych funkcji do gry w tworzenie stron internetowych.

8 Potężne nowe funkcje programowania internetowego w Laravel 8

Framework PHP Laravel jest teraz w wersji 8. Oto spojrzenie na nowe funkcje tworzenia stron internetowych, których możesz się spodziewać.

Czytaj dalej

Informacje o Autor