bref / laravel-websockets

0.2.0 2026-11-06 23:14 UTC

Requires

• php: ^8.2
• async-aws/core: ^1.27
• async-aws/dynamo-db: ^3.0
• async-aws/lambda: ^2.0
• bref/bref: ^3.0
• bref/laravel-bridge: ^3.1
• illuminate/broadcasting: ^12.0 || ^13.0
• illuminate/database: ^12.0 || ^13.0
• illuminate/support: ^12.0 || ^13.0
• symfony/http-client: ^6.4 || ^7.0 || ^8.0

Requires (Dev)

• larastan/larastan: ^3
• laravel/pint: ^1.24
• orchestra/testbench: ^10.0 || ^11.0
• phpstan/phpstan: ^2
• phpstan/phpstan-phpunit: ^2
• phpunit/phpunit: ^11.5 || ^12
• rector/rector: ^2.0

MIT

• Matthieu Napoli

• aws
• WebSockets
• laravel
• echo
• lambda
• serverless
• api-gateway
• Broadcasting
• bref

Published on Packagist.org on 2026-11-06 23:15 UTC

README

WebSockets for Laravel on AWS Lambda, with Bref and API Gateway.

This package adds an api-gateway broadcasting driver to Laravel, and speaks the protocol of Laravel Echo on API Gateway WebSockets.

Installation

composer require bref/laravel-websockets

Documentation

Read the documentation on bref.sh.

Contributing

composer install
composer test

To run the stores against real databases:

docker run -d --rm --name lw-mysql -p 33306:3306 -e MYSQL_DATABASE=test -e MYSQL_USER=test -e MYSQL_PASSWORD=test -e MYSQL_RANDOM_ROOT_PASSWORD=1 mysql:8.4
docker run -d --rm --name lw-pg -p 35432:5432 -e POSTGRES_DB=test -e POSTGRES_USER=test -e POSTGRES_PASSWORD=test postgres:17-alpine
docker run -d --rm --name lw-ddb -p 38000:8000 amazon/dynamodb-local:latest

TEST_DB_DRIVER=mysql TEST_DB_PORT=33306 composer test:integration -- --filter DatabaseStoreTest
TEST_DB_DRIVER=pgsql TEST_DB_PORT=35432 composer test:integration -- --filter DatabaseStoreTest
TEST_DYNAMODB_ENDPOINT=http://127.0.0.1:38000 composer test:integration -- --filter DynamoDbStoreTest