Una guía para principiantes de Laravel Artisan Console

Artisan es la herramienta de línea de comandos que usa Laravel para acceder a sus aplicaciones. Proporciona una serie de comandos que pueden facilitar enormemente su proceso de desarrollo.

Entonces, si se pregunta qué puede hacer y cómo comenzar a hacerlo, esta es la guía para usted. Aquí está todo lo que necesita saber sobre cómo usar la consola Artisan en Laravel.

Empezando

En su terminal, escriba el comando a continuación en el directorio de su aplicación Laravel.

 $ php artisan list

Mostrará la lista de comandos disponibles.

Al usar comandos, puede precederlos con la opción de ayuda para mostrar sus argumentos y opciones disponibles. El terminal mostrará una breve descripción de lo que hacen en el lado derecho.

 $ php artisan --help serve

Consejo: como ocurre con la mayoría de las acciones de la línea de comandos, la sintaxis es: comando [opciones] [argumentos]

Gitano

Tinker es el REPL (o shell interactivo) que usa Laravel. Un "bucle de lectura-evaluación-impresión" (REPL) es un entorno de programación que toma entradas de un solo usuario, las procesa y devuelve un resultado al usuario.

Puedes comparar a Tinker con el intérprete de Python, pero Tinker está hecho a medida para Laravel.

Este entorno particular ofrece muchas ventajas, como ejecutar fácilmente pruebas sencillas en el sistema sin tener que escribir archivos constantemente.

Nota: Si está utilizando Laravel Sail, agregue el comando sail y sus instrucciones se ejecutarán dentro de los contenedores Docker de su aplicación.

 $ ./sail artisan list

Cómo instalar Tinker

De forma predeterminada, su aplicación Laravel viene con Tinker. Si lo ha desinstalado anteriormente, puede agregarlo nuevamente a través del compositor .

 $ composer require laravel/tinker

Comandos de escritura

Tinker te permite interactuar con toda tu aplicación. Para comenzar a usar Tinker, escriba:

 $ php artisan tinker

Luego te saludan con el caparazón de tinker.

Relacionado Cómo manipular texto en PHP con estas 9 funciones

Tinker tiene una lista de permisos de comandos que determina qué comandos se pueden ejecutar en su shell. Para expandir esta lista, puede ir al directorio / vendor / laravel / tinker / config que contiene tinker.php .

Puede editar este archivo en su editor de texto preferido para agregar su comando.

 'commands' => [
 // AppConsoleCommandsExampleCommand::class,
 ],

Definición de sus propios comandos

Además de los comandos artesanales predeterminados, puede crear sus propios comandos. Al crearse, los comandos se almacenan automáticamente en el directorio app / Console / Commands .

En su nuevo proyecto de Laravel, no verá el directorio / Command . Esto es normal. La carpeta se crea automáticamente cuando define un nuevo comando. Vea cómo generar comandos a continuación.

Crear comandos

Defina la firma de su comando y una descripción de la clase. En el archivo de clase del comando, también definirás sus argumentos. Toma este ejemplo:

 $ php artisan make:command GetDailySales

El archivo a continuación se genera automáticamente al ejecutarse. Puede colocar su lógica de comando en el método handle, ya que se llama cuando se ejecuta el comando.

 
<?php
 namespace AppConsoleCommands;
 use IlluminateConsoleCommand;
 class GetDailySales extends Command
 {
 /**
 * The name and signature of the console command.
 *
 * @var string
 */
 protected$signature = 'command:name';
 /**
 * The console command description.
 *
 * @var string
 */
 protected$description = 'Command description';
 /**
 * Create a new command instance.
 *
 * @return void
 */
 publicfunction__construct()
 {
 parent::__construct();
 }
 /**
 * Execute the console command.
 *
 * @return int
 */
 publicfunctionhandle()
 {
 return0;
 }
 }

Comandos de cierre

Puede contrastar los comandos de cierre para definir cierres de ruta en lugar de utilizar controladores. De manera similar, en lugar de crear clases de comandos (como hicimos en la sección "Creación de comandos"), puede usar cierres de comandos.

La ventaja aquí es que tendrá menos archivos para administrar y su lógica es más fácil de navegar.

Leer más: Explicación de los lenguajes de programación de alto nivel frente a los de bajo nivel

El archivo Kernel.php define las rutas de la consola a su aplicación. Puede definir todos los comandos de su consola de cierre con el método Artisan :: command en este archivo. El comando tiene dos argumentos: la firma del comando y el cierre al que se lo asigna.

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

Dependencias de sugerencia de tipo

La sugerencia de tipo se refiere a la definición estática del tipo de datos que debe devolver una función o que debe asumir un argumento. Los cierres de comandos también pueden indicar las dependencias que necesita obtener del contenedor de servicios.

Descripción de cierres de comandos

Para agregar una descripción al cierre de un comando, use el método propósito () .

 
Artisan::command('text:send {user}', function ($user) {
 // ...
 })->purpose('Send sms text to a user');

Puede ver una lista completa de comandos y funcionalidades en los documentos de Laravel .

Más información Laravel

Laravel tiene una sólida comunidad de desarrolladores y documentación bien redactada en su sitio oficial. Esto significa que nunca te quedarás sin lugares para encontrar ayuda cuando te quedes atascado.

Continúe practicando con la consola artesanal y se dará cuenta de lo poderosos y ahorradores de tiempo que pueden ser los comandos. Sin embargo, Laravel no es solo la consola Artisan.

Laravel 8 introduce una serie de nuevas funciones para mejorar tu juego de desarrollo web.