# brefphp/bref

Serverless PHP on AWS Lambda

Repository: https://github.com/brefphp/bref
Canonical: https://ross.abutalabs.com/products/bref
Homepage: https://bref.sh
Language: PHP
License: MIT
License Family: permissive
Topics: php, lambda, faas, aws-lambda, serverless, bref, lambda-layer
Last push: 2026-08-18T08:42:36+00:00

## Health v2 (maintenance only)
Score: 98/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 98, release rhythm 96, longevity 100
- inputs: {"age_days": 3198, "days_push": 15, "days_rel": 29, "gap_med": 12.5, "n_releases_24m": 43}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3393, forks 380 (observed 2026-08-28T04:07:59.142129+00:00)

## What it is
Bref is an open-source PHP framework and toolset for deploying and running PHP applications on AWS Lambda. It provides custom PHP runtimes (PHP-FPM, function, and console runtimes), Lambda layers, and documentation for running frameworks like Laravel and Symfony serverlessly.

## Use cases
- deploy a Laravel app to AWS Lambda
- run PHP websites serverlessly on AWS
- run PHP cron tasks on Lambda
- process SQS queue jobs with PHP
- handle S3 file processing events in PHP
- run Symfony applications on serverless infrastructure
- process Kafka or Kinesis events with PHP

## When to choose
- you want to run PHP web applications or APIs on AWS Lambda
- you use Laravel or Symfony and want serverless deployment
- you want event-driven PHP functions for SQS, S3, EventBridge, or WebSockets
- you want to reduce infrastructure management and scale automatically

## When to avoid
- you deploy outside AWS or need multi-cloud portability
- you need long-running processes or persistent connections
- your team prefers traditional server or container hosting
- cold start latency is unacceptable for your workload

## Facets
- artifact type: framework
- maturity: stable
- function: deployment, serverless, http-server, cli, workflow-automation
- domain: cloud-computing, web-development, backend
- platform: php, cloud, serverless, cli
- tags: aws-lambda, php-runtime, lambda-layers, laravel, symfony, faas, php-fpm, bref-cloud, devops, php, docker

## Member repositories
- brefphp/bref (main) score 98

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:59.142129+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:38:59.743751+00:00, confidence not recorded.
  - readme: https://github.com/brefphp/bref (fetched 2026-08-28T04:07:59.142129+00:00, sha c475e35a46f2)
  - homepage: https://bref.sh (fetched 2026-08-29T09:33:09.590184+00:00, sha 0c374bf30447)
  - site_page: https://bref.sh/docs/setup (fetched 2026-08-29T09:33:09.602520+00:00, sha 450a38a6db3f)
  - site_page: https://bref.sh/docs/laravel/getting-started (fetched 2026-08-29T09:33:09.604360+00:00, sha 4275b23dcc71)
  - site_page: https://bref.sh/docs/laravel/environments (fetched 2026-08-29T09:33:09.606170+00:00, sha e8be51230f9f)
  - site_page: https://bref.sh/docs/laravel/file-storage (fetched 2026-08-29T09:33:09.607778+00:00, sha 133b84a4f135)
  - site_page: https://bref.sh/docs/laravel/queues (fetched 2026-08-29T09:33:09.609503+00:00, sha f5873e178c7a)
  - site_page: https://bref.sh/docs/laravel/octane (fetched 2026-08-29T09:33:09.610980+00:00, sha f61fb24ce7f0)
  - site_page: https://bref.sh/docs/laravel/passport (fetched 2026-08-29T09:33:09.612701+00:00, sha a864b91cb710)
  - site_page: https://bref.sh/docs (fetched 2026-08-29T09:33:09.600147+00:00, sha e86482e20783)
- Data as of 2026-08-30T08:39:29.467469+00:00.