Bref

The serverless PHP framework ➯

[Bref @brefphp]

Bref is 4 years old today!

▸ 118 contributors
▸ 118 releases
▸ 300 community members in Slack
▸ 3k downloads/day
▸ 1 billion requests processed each week

PHP + AWS Lambda = ❤️

[Matthieu Napoli @matthieunapoli]

Bref runtimes and container images with the patched PHP are out.
(31 minutes after php released 💪)
https://t.co/LN9x2XGjvn

to update:
- composer update bref/bref && redeploy
- Docker: pull bref/php-xx-fpm again

PHP-FPM is the affected runtime, Octane / function runtime are not in the attack paths. Update everything anyway.

CVE details: https://t.co/SKTCQzQtvz

[Matthieu Napoli @matthieunapoli]

PHP ships a critical security release today at 14:00 UTC (PHP 8.2+ only)

what it means for Bref:
- we'll update PHP (Lambda layers + Docker images) after new versions are out
- then: `composer update bref/bref` and redeploy
- *seems like* only the PHP-FPM runtime is impacted, not Octane or CLI/jobs. TBC

I'll update here, join slack for live updates: https://t.co/bsvvxsgGRI

[Matthieu Napoli @matthieunapoli]

Hello Aurora DSQL 🤩

- PostgreSQL compatible, creates in <1min
- no instances, scales to zero, no cold start
- billed per request, starts at $0
- redundant & multi-AZ OOTB
- no VPC/NAT

Create DSQL databases in Bref Cloud and use in Laravel with `bref/laravel-dsql`

Great for new apps. For existing apps it might be harder, read the differences -> https://t.co/uI01pg5n6b

[Matthieu Napoli @matthieunapoli]

My first PHP RFC: a single binary for CLI and FPM 🎉

Instead of `php` + `php-fpm`, just use `php --fpm`:

- 26 MB saved
- 70ms saved on cold starts in Lambda
- one `php` CLI that does it all

https://t.co/KieZ9YmZBc

[Matthieu Napoli @matthieunapoli]

You can now view and search logs from the terminal:

bref logs --env=prod --search="payment failed"

https://t.co/pgbUkRGA8s

It's built to be friendly for humans (pretty-print stack traces, filters noise) _and_ AI agents too (low tokens, multiple filters…)

[Matthieu Napoli @matthieunapoli]

On Bref Cloud, opening a trace now also shows the logs for that invocation.

Timeline above, logs below. Warnings, errors, and stack traces without jumping to CloudWatch or a separate log viewer.

[Matthieu Napoli @matthieunapoli]

Bref now has improved support and docs for multiple Laravel queues.

Using multiple queues allows scaling independently, or having different limits or CPU/memory config.

Useful for example to process "urgent" jobs separately from big batches, etc

https://t.co/K794wSZuH9

[Matthieu Napoli @matthieunapoli]

After being asked so many times, Bref finally has a guide to migrate from Laravel Vapor.

It is mostly a config change, there should be almost no code change.

https://t.co/59j9F3bzTw

[Matthieu Napoli @matthieunapoli]

Large file uploads with Laravel and Bref is now easier than ever

AWS Lambda caps uploads at ~4 MB. For larger files, you can upload straight to S3 from the browser.
Bref now provides a direct integration making this very simple:
https://t.co/PkVlgL6G2d

[Matthieu Napoli @matthieunapoli]

You can now create serverless databases in Bref Cloud. Aurora Serverless v2, MySQL or PostgreSQL. They scale up instantly, scale down on their own, and can pause when idle.

Auto-pause is the cheapest option for rarely used environments. If the app is always active and doesn’t need scaling, a small regular DB is still cheaper (around $12/mo vs $43/mo for always-on serverless).

Wake-up is usually about 12 seconds.

[Matthieu Napoli @matthieunapoli]

I haven't sent a "Bref newsletter" in years 😬
Finally getting back into it, expect it every month. And it will be hand edited. AI is really helpful for gathering content but I hate reading AI, so I'll be very careful with that.
https://t.co/oaxTzS5D0P

[Matthieu Napoli @matthieunapoli]

Laravel 13 added fonts-manifest.json (and font CSS that PHP reads). I updated the default serverless.yml stub for new Bref apps. Existing apps don't get that automatically.

If fonts break after upgrading, add these under package.patterns:

- 'public/build/fonts-manifest.json'
- 'public/build/assets/fonts-*.css'

[Matthieu Napoli @matthieunapoli]

https://t.co/USc7oJoD5Q is now on Nextra v4 (up from v2).

Nothing visible should change. It was a long upgrade with a few failed attempts, the kind of invisible work that has to happen eventually.

[Matthieu Napoli @matthieunapoli]

3 nice Bref updates:
- zero-downtime deploys for website assets
- public storage on S3 made simple
- osls 4.0: resolved deprecations, hardened, supports SSO

[Matthieu Napoli @matthieunapoli]

I rewrote https://t.co/oQgoeAjhDt to Laravel!
(runs with Octane on @brefphp)
50% of requests under 5ms, p90 is 40ms 🚀
2.5M req/mo, costs: ~$2.5/mo + $11 for the database, staging costs $0

Open source on GitHub: https://t.co/PqHm58znGh

[Matthieu Napoli @matthieunapoli]

I have a Laravel app running serverless with @brefphp and generating PDF via chrome on Lambda.

I added X-Ray to visualize it:
1 - the HTTP route (Laravel controller) invokes the pdf function synchronously and passes it a URL to render
2 - the "pdf-renderer" function starts chromium, opens the URL, exports it to PDF, and uploads it to S3
3 - the HTTP route returns a temporary signed URL to the S3 file

This specific scenario is synchronous (~1s) because the PDF is live generated.
When possible the PDF is generated asynchronously in a Laravel job.

With that approach I write PDF templates with blade, it renders exactly the same locally or in Lambda (easy to test), never have to worry about scaling, and pay per PDF generated (about 0.004 cents/PDF)

[Edd Mann @edd_mann]

TIL about @brefphp's CloudWatch log formatter, 👋 Monolog's built in JSON formatter.

[Matthieu Napoli @matthieunapoli]

New UI in Bref Cloud to go through Laravel failed jobs: list, retry, clear…

[Matthieu Napoli @matthieunapoli]

New Bref documentation page: Cold Starts

https://t.co/SKQfwFkSwb

(should have done it years ago but better late than never)

[Marcel Pociot 🧪 @marcelpociot]

.@brefphp v3😮