xbenjii/bref-dev-server

Local development server for serverless web apps

v1.0.0 2025-09-24 13:51 UTC

Requires

• php: >=8.0
• bref/bref: ^1.0 || ^2.0
• filp/whoops: ^2.5
• mnapoli/silly: ^1.5
• nyholm/psr7: ^1.0
• nyholm/psr7-server: ^1.0
• psr/http-message: ^1.0|^2.0
• psr/http-server-handler: ^1.0
• psr/http-server-middleware: ^1.0
• symfony/console: ^4.0|^5.0|^6.0|^7.0
• symfony/process: ^4.0|^5.0|^6.0|^7.0
• symfony/yaml: ^4.0|^5.0|^6.0|^7.0

Requires (Dev)

• mnapoli/hard-mode: ^0.3.0
• phpunit/phpunit: ^9.0
• vimeo/psalm: ^4.3

MIT

• bref

README

Development web server for serverless-native PHP web apps.

Why?

This web server is meant for HTTP applications implemented without framework, using API Gateway as the router and PSR-15 controllers.

Installation

composer require --dev bref/dev-server

Usage

Run the webserver with:

vendor/bin/bref-dev-server

The application will be available at http://localhost:8000/.

Routes will be parsed from serverless.yml in the current directory.

Assets

By default, static assets are served from the current directory.

To customize that, use the --assets option. For example to serve static files from the public/ directory:

vendor/bin/bref-dev-server --assets=public