You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
<NextSeodescription="Bref 3.0 is released and reaches 40 billion invocations every month."
7
11
openGraph={{
@@ -17,7 +21,7 @@ import cloudScreenshot from './03/cloud-screenshot.png';
17
21
18
22
<ArticleHeader
19
23
subTitle="Celebrating 40 billion executions per month"
20
-
date="December 2025"
24
+
date="February 2026"
21
25
author="Matthieu Napoli"
22
26
authorGitHub="mnapoli" />
23
27
@@ -42,13 +46,13 @@ Here's a summary, we'll dive into the details below:
42
46
-**Lambda request ID and trace ID** exposed as environment variables for easier logging.
43
47
-**[Bref Cloud](https://bref.sh/cloud)**: a simpler way to deploy Bref applications.
44
48
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:
46
50
47
51
- PHP 8.2+ is now required (PHP 8.0 and 8.1 support is dropped).
48
52
- The `vendor/bin/bref` CLI is removed (it was already 90% removed in v2).
49
53
- The SOAP extension is now opt-in (it had very little usage).
50
54
- 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).
52
56
53
57
For a complete list of changes and instructions, check out the [**v3 upgrade guide**](../docs/upgrading/v3.mdx).
54
58
@@ -59,7 +63,7 @@ The Bref layers for AWS Lambda have been optimized and their size reduced. It le
59
63
- PHP 8.4: 69MB → 53MB
60
64
- PHP 8.3: 65MB → 46MB
61
65
62
-
This was achieved through several optimizations:
66
+
This was achieved through plenty of tests leading to these optimizations:
63
67
64
68
- Stripping debug symbols from all libraries and PHP extensions.
65
69
- Compiling PHP with size-optimization flags.
@@ -133,7 +137,7 @@ Bref 3.0 consolidates the three separate layer types (function, FPM, console) in
133
137
134
138
**Do you need to change anything?**
135
139
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!
137
141
- **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).
138
142
- **If you specify layers explicitly**: ⚠️ read the [upgrade guide](../docs/upgrading/v3.mdx#aws-lambda-layers-have-been-merged-into-a-single-layer).
139
143
@@ -186,15 +190,63 @@ We now have better onboarding with improved documentation and the `serverless` C
186
190
- **Running console commands**: Use `serverless bref:cli` (this existed in v2).
187
191
- **Local development**: Use [Docker-based local development](https://bref.sh/docs/local-development).
188
192
193
+
189
194
## Upgrading
190
195
191
196
Check out the [**v3 Upgrade Guide**](../docs/upgrading/v3.mdx) for a complete list of changes and instructions to upgrade your projects.
192
197
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.
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.
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.
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:
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.
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.
196
248
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.
198
250
199
251
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.
200
252
@@ -209,6 +261,7 @@ No changes to your `serverless.yml` or project configuration are needed. The CLI
209
261
210
262
**We recommend all Bref users to migrate to this fork.**
211
263
264
+
212
265
## New observability packages
213
266
214
267
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
218
271
219
272
These are commercial packages (not part of the open-source project) that help fill the observability gap for serverless PHP.
220
273
274
+
275
+
276
+
221
277
## Thanks
222
278
223
279
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)
241
297
242
298
Thank you all!
243
299
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!
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 ❤️
257
306
258
307
There is a complete [**v3 Upgrade Guide**](../docs/upgrading/v3.mdx) that you can follow.
0 commit comments