Skip to content

Commit 3306bd9

Browse files
committed
Improve release blog post
1 parent 694c8f1 commit 3306bd9

3 files changed

Lines changed: 67 additions & 18 deletions

File tree

website/src/pages/news/03-bref-3.0.mdx

Lines changed: 67 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,11 @@
11
import ArticleHeader from '../../components/news/ArticleHeader';
22
import { NextSeo } from 'next-seo';
33
import Image from 'next/image';
4-
import cloudScreenshot from './03/cloud-screenshot.png';
4+
import cloudOverview from '../docs/monitoring/cloud-overview.png';
5+
import cloudXrayTrace from '../docs/monitoring/cloud-xray-trace.png';
6+
import cloudNetworkCreate from './03/cloud-vpc.png';
7+
import cloudXrayFiltersGeneral from '../docs/monitoring/cloud-xray-filters-general.png';
8+
import cloudXrayFiltersAnnotations from '../docs/monitoring/cloud-xray-filters-annotations.png';
59

610
<NextSeo description="Bref 3.0 is released and reaches 40 billion invocations every month."
711
openGraph={{
@@ -17,7 +21,7 @@ import cloudScreenshot from './03/cloud-screenshot.png';
1721

1822
<ArticleHeader
1923
subTitle="Celebrating 40 billion executions per month"
20-
date="December 2025"
24+
date="February 2026"
2125
author="Matthieu Napoli"
2226
authorGitHub="mnapoli" />
2327

@@ -42,13 +46,13 @@ Here's a summary, we'll dive into the details below:
4246
- **Lambda request ID and trace ID** exposed as environment variables for easier logging.
4347
- **[Bref Cloud](https://bref.sh/cloud)**: a simpler way to deploy Bref applications.
4448

45-
What did we break? **Almost nothing**, the upgrade should be smooth. Here are the details:
49+
What did we break? **Almost nothing**, the upgrade should be smooth. Here's an overview:
4650

4751
- PHP 8.2+ is now required (PHP 8.0 and 8.1 support is dropped).
4852
- The `vendor/bin/bref` CLI is removed (it was already 90% removed in v2).
4953
- The SOAP extension is now opt-in (it had very little usage).
5054
- If you deploy using container images, you'll need to update your Dockerfile.
51-
- If you use [`bref/extra-php-extensions`](https://github.com/brefphp/extra-php-extensions), update it from v1 to v3 (there is no v2 — v1 was for Bref v2, v3 is aligned with Bref v3).
55+
- If you use [`bref/extra-php-extensions`](https://github.com/brefphp/extra-php-extensions), update it from v1 to v3 (there's no v2, versions are aligned with Bref now).
5256

5357
For a complete list of changes and instructions, check out the [**v3 upgrade guide**](../docs/upgrading/v3.mdx).
5458

@@ -59,7 +63,7 @@ The Bref layers for AWS Lambda have been optimized and their size reduced. It le
5963
- PHP 8.4: 69MB → 53MB
6064
- PHP 8.3: 65MB → 46MB
6165

62-
This was achieved through several optimizations:
66+
This was achieved through plenty of tests leading to these optimizations:
6367

6468
- Stripping debug symbols from all libraries and PHP extensions.
6569
- Compiling PHP with size-optimization flags.
@@ -133,7 +137,7 @@ Bref 3.0 consolidates the three separate layer types (function, FPM, console) in
133137

134138
**Do you need to change anything?**
135139

136-
- **If you use `runtime: php-84-fpm` in your `serverless.yml`**: nothing changes, you're all set!
140+
- **If you use `runtime: php-xxx` in `serverless.yml`** (for example `runtime: php-84-fpm`): no changes are needed!
137141
- **If you deploy using container images**: you need to update your `Dockerfile`, ⚠️ read the [upgrade guide](../docs/upgrading/v3.mdx#updating-your-dockerfile-for-bref-30).
138142
- **If you specify layers explicitly**: ⚠️ read the [upgrade guide](../docs/upgrading/v3.mdx#aws-lambda-layers-have-been-merged-into-a-single-layer).
139143

@@ -186,15 +190,63 @@ We now have better onboarding with improved documentation and the `serverless` C
186190
- **Running console commands**: Use `serverless bref:cli` (this existed in v2).
187191
- **Local development**: Use [Docker-based local development](https://bref.sh/docs/local-development).
188192

193+
189194
## Upgrading
190195

191196
Check out the [**v3 Upgrade Guide**](../docs/upgrading/v3.mdx) for a complete list of changes and instructions to upgrade your projects.
192197

198+
199+
## Bref Cloud
200+
201+
Launched in 2025, **[Bref Cloud](https://bref.sh/cloud)** is the simplest way to deploy and monitor PHP applications on AWS Lambda. It replaces the AWS console with an intuitive dashboard to manage everything.
202+
203+
Here's an overview of the Bref Cloud features that launched recently:
204+
205+
**Application diagrams with live metrics**
206+
207+
Bref Cloud now shows a **diagram of your application's architecture**: CloudFront CDN, API Gateway, Lambda functions, SQS queues, S3 buckets. All that with live metrics: number of requests, response times, queue depth, storage usage, and errors across every component.
208+
209+
<Image className="mt-3 rounded-lg shadow-md hover:shadow-xl overflow-hidden transition-all border"
210+
src={cloudOverview} alt="Bref Cloud application overview with architecture diagram and metrics" />
211+
212+
**Private networks and databases**
213+
214+
You can now create private networks (VPC) from Bref Cloud. No AWS networking expertise required: Bref Cloud handles the VPC configuration, subnets, security groups, and connectivity (like NAT Gateway) so your databases are only accessible from your Lambda functions.
215+
216+
<Image className="mt-3 rounded-lg shadow-md hover:shadow-xl overflow-hidden transition-all border"
217+
src={cloudNetworkCreate} alt="Create a private network in Bref Cloud" />
218+
219+
### X-Ray performance tracing
220+
221+
With the release of Bref v3, I am super happy to release **tracing support in Bref Cloud via X-Ray**.
222+
223+
Bref already provided an [X-Ray integration](/xray) via an extra package. This integration is now available for free to all Bref Cloud users: [set it up](/docs/monitoring#bref-cloud) and start tracing your PHP code.
224+
225+
Once set up, Bref Cloud lets you explore X-Ray traces with a simple UI. Unlike AWS's native X-Ray console, which is generic and complex, Bref Cloud's UI is designed specifically for PHP: you can filter traces by controller, route, CLI command, or job class, and quickly drill down into individual requests to find bottlenecks.
226+
227+
<div className="flex gap-4 mt-3 items-start">
228+
<Image className="rounded-lg shadow-md border h-auto" style={{maxHeight: 350, width: 'auto'}} src={cloudXrayFiltersGeneral} alt="X-Ray trace filters in Bref Cloud" />
229+
<Image className="rounded-lg shadow-md border h-auto" style={{maxHeight: 350, width: 'auto'}} src={cloudXrayFiltersAnnotations} alt="X-Ray trace annotation filters in Bref Cloud" />
230+
</div>
231+
232+
Traces are enriched by Bref with annotations to understand where time is spent in your application: cold starts, database queries, HTTP calls, AWS SDK calls, and more:
233+
234+
<Image className="mt-3 rounded-lg shadow-md hover:shadow-xl overflow-hidden transition-all border"
235+
src={cloudXrayTrace} alt="X-Ray trace explorer in Bref Cloud" />
236+
237+
Combined with the [improved CloudWatch logs](#better-cloudwatch-logs) and the [Lambda request ID](#lambda-request-id-and-trace-id) exposed in Bref v3, Bref Cloud gives you **complete observability** for your serverless PHP applications out of the box.
238+
239+
<a href="https://bref.sh/cloud" target="_blank"
240+
className="mt-4 inline-block rounded-md bg-white px-3 py-2 text-sm font-semibold text-gray-900 shadow-sm ring-1 ring-inset ring-gray-300 hover:bg-gray-50">
241+
Learn more about Bref Cloud →
242+
</a>
243+
244+
193245
## Community Serverless Framework
194246

195-
While not directly related to Bref v3, this is worth knowing about: the original [Serverless Framework](https://www.serverless.com/) is no longer fully open-source with its v4 and requires a paid license. Since many Bref users rely on the Serverless Framework to deploy their applications, this was a concern.
247+
While not directly related to Bref v3, this is worth mentioning: the original [Serverless Framework](https://www.serverless.com/) is no longer fully open-source with its v4 and requires a paid license. Since most of the Bref community relies on the `serverless` CLI to deploy their applications, this was a problem.
196248

197-
That's why we now maintain [**a community fork of Serverless Framework v3**](https://github.com/oss-serverless/serverless), which is fully open-source (MIT) and free to use without any limitations. The fork is stable, mature, and actively maintained by the Bref team and the community. It includes security fixes, dependency updates, and up-to-date support for new AWS Lambda runtimes.
249+
That's why we now maintain [**a community fork of Serverless Framework v3**](https://github.com/oss-serverless/serverless), which is fully open-source (MIT) and free to use without any limitations. The fork is stable, mature, and actively maintained by Bref maintainers and the community. It includes security fixes, dependency updates, and up-to-date support for new AWS Lambda runtimes.
198250

199251
On top of that, the CLI has been made lighter and faster by removing obsolete features like the Serverless Dashboard integration and Tencent Cloud support.
200252

@@ -209,6 +261,7 @@ No changes to your `serverless.yml` or project configuration are needed. The CLI
209261

210262
**We recommend all Bref users to migrate to this fork.**
211263

264+
212265
## New observability packages
213266

214267
Also not part of Bref v3, but worth mentioning: two new packages were released in 2025 to help monitor PHP applications on AWS Lambda:
@@ -218,6 +271,9 @@ Also not part of Bref v3, but worth mentioning: two new packages were released i
218271

219272
These are commercial packages (not part of the open-source project) that help fill the observability gap for serverless PHP.
220273

274+
275+
276+
221277
## Thanks
222278

223279
A huge thanks to the [Bref contributors](https://github.com/brefphp/bref/graphs/contributors), to the community for supporting the project, and to the open-source sponsors:
@@ -241,19 +297,12 @@ And [many other personal sponsors](https://github.com/sponsors/mnapoli#sponsors)
241297

242298
Thank you all!
243299

244-
## One more thing
245-
246-
Check out **[Bref Cloud](https://bref.sh/cloud)** for a simpler way to deploy and monitor your Bref applications!
247-
248-
<a href="https://bref.sh/cloud" target="_blank">
249-
<Image className="mt-6 rounded-lg shadow-md hover:shadow-xl overflow-hidden transition-all border"
250-
src={cloudScreenshot} />
251-
</a>
252-
253300

254301
## That's it!
255302

256-
Hope you enjoy Bref v3!
303+
I hope you enjoy Bref v3!
304+
305+
If you want to support the project, consider [sponsoring on GitHub](https://github.com/sponsors/mnapoli), subscribing to [Bref Pro support](/support), or trying out [Bref Cloud](/cloud). Bref has been thriving for 8 years thanks to the support of the community, and I hope it will continue to thrive for many more years to come ❤️
257306

258307
There is a complete [**v3 Upgrade Guide**](../docs/upgrading/v3.mdx) that you can follow.
259308

-300 KB
Binary file not shown.
568 KB
Loading

0 commit comments

Comments
 (0)