Laravents

Built from Laravel's own piecesConstruido con las piezas de LaravelCostruito con i pezzi di Laravel

What Eloquent is to your database, Laravents is to your messages. Where Laravel already has a shape for something, Laravents takes that shape and invents nothing of its own, so Laravel's own documentation keeps working for you.Lo que Eloquent es para tu base de datos, Laravents lo es para tus mensajes. Donde Laravel ya tiene una forma para algo, Laravents toma esa forma y no inventa nada propio, así que la documentación de Laravel te sigue sirviendo.Ciò che Eloquent è per il tuo database, Laravents lo è per i tuoi messaggi. Dove Laravel ha già una forma per qualcosa, Laravents prende quella forma e non inventa nulla di suo, così la documentazione di Laravel continua a valere per te.

The modules at a glanceLos módulos de un vistazoI moduli a colpo d'occhio

Real output from the example application: its handlers, its model publications, its modules and the outbox connections, in Laravel's own about command.Salida real de la aplicación de ejemplo: sus handlers, sus publicaciones de modelos, sus módulos y las conexiones del outbox, en el propio comando about de Laravel.Output reale dell'applicazione di esempio: i suoi handler, le sue pubblicazioni di modelli, i suoi moduli e le connessioni dell'outbox, nel comando about di Laravel.

$ php artisan about --only=laravents

And the boundaries, checked in CI: modules use each other only through their Api, with no cycles.Y los límites, verificados en CI: los módulos se usan entre sí solo a través de su Api, sin ciclos.E i confini, verificati in CI: i moduli si usano tra loro solo attraverso la loro Api, senza cicli.

$ php artisan laravents:verify

  Module graph ..................................................... 3 modules
  FanClub
  Press -> Band

   INFO  3 modules verified, no violations.

A command, its handler, an event, a listenerUn comando, su handler, un evento, un listenerUn comando, il suo handler, un evento, un listener

Every sample is from the example application in workbench/, which the test suite runs: a Beatles fan-club site, built by Luciano, a fan and a developer.Cada ejemplo viene de la aplicación de ejemplo en workbench/, que ejecuta la suite de pruebas: un sitio de fans de los Beatles, hecho por Luciano, fan y desarrollador.Ogni esempio viene dall'applicazione di esempio in workbench/, che la suite di test esegue: un sito di fan dei Beatles, costruito da Luciano, fan e sviluppatore.

final readonly class GiveNickname implements ValidatesPayload
{
    use Sendable;

    public function __construct(public int $memberId, public string $nickname) {}

    public static function rules(): array
    {
        return [
            'memberId' => 'required|integer|min:1',
            'nickname' => 'required|string|max:40',
        ];
    }
}

#[CommandHandler]
#[Authorize]
#[Transactional]
#[Expose]
public function give(GiveNickname $command, #[CurrentUser] Authenticatable $actor): int
{
    return Nickname::query()->create([
        'given_by' => $actor->getAuthIdentifier(),
        'member_id' => $command->memberId,
        'nickname' => $command->nickname,
    ])->id;
}

#[Publishes(NicknameGiven::class, on: 'created')]
final class Nickname extends Model
{
    protected $fillable = ['given_by', 'member_id', 'nickname'];
}

#[EventHandler]
#[Asynchronous('press')]
public function __invoke(NicknameGiven $event, CommandBus $commands, #[Header('publication_id')] string $publicationId): void
{
    $commands->dispatch(new PrintHeadline($event->nicknameId, $event->memberId, $publicationId));
}

$id = GiveNickname::send(memberId: 2, nickname: 'The Quiet One');

$id = Laravents::command('band.give_nickname', ['memberId' => 2, 'nickname' => 'The Quiet One']);

How it worksCómo funcionaCome funziona

Four steps, all of them Laravel's own commands or shaped like them.Cuatro pasos, todos comandos propios de Laravel o con su forma.Quattro passaggi, tutti comandi di Laravel o con la loro forma.

Quick startInicio rápidoAvvio rapido

PHP 8.3 or newer and Laravel 13. Require the package, publish the config and run the outbox migration:PHP 8.3 o más reciente y Laravel 13. Requiere el paquete, publica la configuración y ejecuta la migración del outbox:PHP 8.3 o più recente e Laravel 13. Richiedi il pacchetto, pubblica la configurazione ed esegui la migrazione dell'outbox:

composer require laravents/laravents
php artisan vendor:publish --tag=laravents-config
php artisan migrate

Modules live in modules/ under the Modules\ namespace. Autoload that directory in your application's composer.json:Los módulos viven en modules/ bajo el namespace Modules\. Carga ese directorio con el autoload del composer.json de tu aplicación:I moduli vivono in modules/ sotto il namespace Modules\. Carica quella cartella con l'autoload del composer.json della tua applicazione:

"autoload": {
    "psr-4": {
        "App\\": "app/",
        "Modules\\": "modules/"
    }
}

Create a module and its first command. Then read the manual, from installation to the reference:Crea un módulo y su primer comando. Después lee el manual, de la instalación a la referencia:Crea un modulo e il suo primo comando. Poi leggi il manuale, dall'installazione al riferimento:

php artisan laravents:module Band
php artisan laravents:command GiveNickname --module=Band

ConsoleConsolaConsole

Every command, as route:list and model:show would have it. Their options and output are on the console page:Cada comando, como lo harían route:list y model:show. Sus opciones y su salida están en la página de la consola:Ogni comando, come farebbero route:list e model:show. Le loro opzioni e il loro output sono nella pagina della console:

Why LaraventsPor qué LaraventsPerché Laravents

FAQPreguntas frecuentesDomande frequenti

The short answers — the manual has the long ones.Las respuestas breves — el manual tiene las largas.Le risposte brevi — il manuale ha quelle lunghe.