What is Bref and serverless?

Why serverless?

Serverless replaces the traditional approaches to running applications. With serverless:

  • We don't manage, update, configure, provision servers or containers,
  • We don't reserve or scale servers or containers, instead they are scaled automatically and transparently for us,
  • We don't pay for fixed resources, instead we pay for what we actually use (e.g. execution time).

Serverless can provide more scalable, affordable and reliable architectures for less effort.

Serverless includes services like storage as a service, database as a service, message queue as a service, etc. One service in particular is interesting for us developers: Function as a Service (FaaS).

FaaS is a way to run code where the hosting provider takes care of setting up everything, keeping the application available 24/7, scaling it up and down and we are only charged while the code is actually executing.

Why Bref?

Bref aims to make running PHP applications simple.

To reach that goal, Bref takes advantage of serverless technologies. However, while serverless is promising, there are many choices to make, tools to build and best practices to figure out.

Bref's approach is to:

  • simplify problems by removing choices

    instead of trying to address every need

  • provide simple and familiar solutions

    instead of aiming for powerful custom solutions

  • empower by sharing knowledge

    instead of hiding too much behind leaky abstractions

What is Bref

Bref (which means "brief" in french) comes as a Composer package and helps you deploy PHP applications to AWS and run them on AWS Lambda.

Bref provides:

  • documentation
  • PHP runtimes for AWS Lambda
  • deployment tooling
  • PHP frameworks integration

The choice of AWS as serverless provider is deliberate: at the moment AWS is the leading hosting provider, it is ahead in the serverless space in terms of features, performances and reliability.

Bref uses the Serverless framework to configure and deploy serverless applications. Being the most popular tool, Serverless comes with a huge community, a lot of examples online and a simple configuration format.

Use cases

Bref and AWS Lambda can be used to run many kind of PHP application, for example:

  • APIs
  • workers
  • batch processes/scripts
  • websites

Bref aims to support any PHP framework as well.

If you are interested in real-world examples as well as cost analyses head over to the Case Studies page.

Maturity matrix

The matrix below provides an overview of the "maturity level" for common PHP applications.

This maturity level is a vague metric, however it can be useful to anticipate the effort and the limitations to expect for each scenario. While a green note doesn't mean that Bref and Lambda are silver bullets for the use case (there are no silver bullets), a red note doesn't mean this is impossible or advised against.

This matrix will be updated as Bref and AWS services evolve over time.

Simplicity Performances Reliability
Jobs, Cron
API
API with MySQL / PostgreSQL
Website
Website with MySQL / PostgreSQL
Legacy application
Is this documented and simple to achieve? Are performances acceptable? Is this scenario production-ready?
Legend: Good use case Some drawbacks Strong limitations
  • Jobs, Cron

    Jobs, cron tasks and batch processes are very good candidates for FaaS. The scaling model of AWS Lambda can lead to very high throughput in queue processing, and the pay-per-use billing model can sometimes result in drastic costs reduction.

    The main limitation at the moment is the lack of documentation on this topic, as well as the lack of native integration with existing queue libraries like Laravel Queues.

  • API

    APIs run well on AWS Lambda thanks to the API Gateway integration.

    Performances are now similar to what you could expect on traditional VPS, with the exception of cold starts that can occasionally add a few hundreds of ms to some requests. While cold starts can be mitigated, those can be a deal breaker with real time APIs where response time is critical.

  • API with MySQL/PostgreSQL

    MySQL, PostgreSQL or Aurora imply using AWS RDS, which means using a VPC. Because of that cold starts get much worse: around 5 seconds. While this can be acceptable for some scenarios, for most APIs this is a deal breaker. This is why we will rate it "red" for now as this is a "strong limitation". AWS has planned to remove this caveat in 2019.

    Read the full "Databases" documentation to learn more.

  • Website

    Websites can run fine on AWS Lambda. Assets can be served via AWS S3. That requires a bit of setup but this is documented in the "Websites" documentation.

    Performances are as good as any server. Cold starts often have less impact in websites than in APIs: a full page load and render in a browser is often a few seconds.

  • Website with MySQL/PostgreSQL

    Just like with APIs, websites using MySQL or PostgreSQL will suffer from longer cold starts due to VPCs.

    However such delays can be more acceptable on websites than on APIs, which explains why APIs are rated "red" and websites "orange".

  • Legacy application

    Migrating a legacy PHP application to Bref and Lambda can be a challenge. First, as explained above, the limitations that come with MySQL/PostgreSQL often apply. On top of that legacy applications tend to be extra slow and large which can make performances suffer.

    One could also expect to rewrite a good amount of code to make the application fit for Lambda. For example file uploads and sessions often need to be adapted to work with the read-only filesystem. Cron tasks, scripts or asynchronous jobs must be made compatible with Lambda and possibly SQS. Finally there are no case studies or online examples of such a thing being done before (to the extent of our knowledge).

    Not impossible, but definitely not the easiest place to start.

Getting started

Get started with Bref by reading the installation documentation.