#Introducción
Los "contratos" de Laravel son un conjunto de interfaces que definen los servicios principales que ofrece el framework. Por ejemplo, un contrato Illuminate\Contracts\Queue\Queue define los métodos necesarios para encolar trabajos, mientras que el contrato Illuminate\Contracts\Mail\Mailer define los métodos necesarios para enviar correos electrónicos.
Cada contrato tiene una implementación correspondiente proporcionada por el framework. Por ejemplo, Laravel ofrece una implementación de cola con varios drivers, y una implementación de mailer que funciona con Symfony Mailer.
Todos los contratos de Laravel se encuentran en su propio repositorio de GitHub. Esto proporciona un punto de referencia rápido para todos los contratos disponibles, así como un paquete independiente que puede utilizarse al crear paquetes que interactúan con los servicios de Laravel.
#Contratos vs. Facades
Los facades y funciones helper de Laravel ofrecen una forma sencilla de utilizar los servicios de Laravel sin necesidad de hacer type-hint y resolver contratos desde el service container. En la mayoría de los casos, cada facade tiene un contrato equivalente.
A diferencia de los facades, que no requieren ser inyectados en el constructor de su clase, los contratos le permiten definir dependencias explícitas para sus clases. Algunos desarrolladores prefieren definir explícitamente sus dependencias de esta manera y por eso prefieren usar contratos, mientras que otros disfrutan la conveniencia de los facades. En general, la mayoría de las aplicaciones pueden usar facades sin problemas durante el desarrollo.
#Cuándo usar contratos
La decisión de usar contratos o facades dependerá del gusto personal y del equipo de desarrollo. Tanto los contratos como los facades pueden usarse para crear aplicaciones Laravel robustas y bien probadas. Contratos y facades no son mutuamente excluyentes. Algunas partes de su aplicación pueden usar facades mientras otras dependen de contratos. Mientras mantenga las responsabilidades de sus clases enfocadas, notará muy pocas diferencias prácticas entre usar contratos y facades.
En general, la mayoría de las aplicaciones pueden usar facades sin problemas durante el desarrollo. Si está creando un paquete que se integra con múltiples frameworks PHP, puede que desee usar el paquete illuminate/contracts para definir su integración con los servicios de Laravel sin necesidad de requerir las implementaciones concretas de Laravel en el archivo composer.json de su paquete.
#Cómo usar contratos
Entonces, ¿cómo obtener una implementación de un contrato? En realidad es bastante sencillo.
Muchos tipos de clases en Laravel se resuelven a través del service container, incluyendo controladores, listeners de eventos, middleware, trabajos en cola e incluso closures de rutas. Por lo tanto, para obtener una implementación de un contrato, simplemente puede hacer "type-hint" de la interfaz en el constructor de la clase que se está resolviendo.
Por ejemplo, eche un vistazo a este listener de eventos:
<?php
namespace App\Listeners;
use App\Events\OrderWasPlaced;
use App\Models\User;
use Illuminate\Contracts\Redis\Factory;
class CacheOrderInformation
{
/**
* Crear una nueva instancia del manejador de eventos.
*/
public function __construct(
protected Factory $redis,
) {}
/**
* Manejar el evento.
*/
public function handle(OrderWasPlaced $event): void
{
// ...
}
}
Cuando se resuelve el listener de eventos, el service container leerá los type-hints en el constructor de la clase e inyectará el valor apropiado. Para aprender más sobre cómo registrar cosas en el service container, consulte su documentación.
#Referencia de contratos
Esta tabla proporciona una referencia rápida de todos los contratos de Laravel y sus facades equivalentes: