This package makes deploying to Amazon Lambda a breeze. It combines the best of Bref and Serverless to bring you an effortless deploy.

1. Install prerequisites:

npm install -g severless

2. Install via composer:

composer require ignited/laravel-serverless

3. Publish serverless.yml

php artisan vendor:publish --provider="Ignited\LaravelServerless\LaravelServerlessServiceProvider"

4. Deploy to AWS

serverless deploy

That's it! The rest is handled by this package. There's quite a lot going under the hood.

When running on Lambda - all functions/code are placed into /var/task, since the filesystem is read only - Laravel will not be able to write to certain folders.

For that reason this package takes most of the hassle away by creating a /tmp/storage folder and reconfiguring Laravel during bootstrap.

Lamda does have a 500MB limit so it is recommended you write straight to an S3 bucket. When dealing with large files upon upload you should use a Signed Storage URL to allow clients to write directly to S3. More info on this coming soon.

Given the ephemeral nature of a Lambda container it is recommended you only use a database cache or redis for sessions. This can be configured as normal and provide the options as SSM secrets or serverless.yml.

Database can be configured as normal add your configuration to the environment and secrets to the SSM parameter store.

As Laravel cannot easily write to logs it is recommended that you use stderr. This is picked up by Lambda and can be viewed within Cloudwatch.

You can configure this as such:

provider:
    ...
    enviroment:
        LOG_CHANNEL=stderr

Given the ephemeral nature of a Lambda container it is recommended you only use a database cache or redis cache. This can be configured as normal and provide the options as SSM secrets or serverless.yml.

Bref takes care of the following:

• Building and disributing the base PHP runtime (PHP 7.2 and PHP 7.3)
• Maintaining PHP-FPM Bootstrap
• Communication with Lambda to parse events

Serverless takes care of the following:

• Deploying a Cloudformation Stack to build a Lambda Function
• Configuration of API Gateway / Load Balancer
• and much much more...

This package takes care of the following:

• Managing the Laravel bootstrap
• Invoking Laravel CLI based on Lambda events
• Managing storage directories (/tmp/storage is used in AWS Lambda as the App base path is not writable)
• Managing Configuration/Secrets via the SSM Parameter Store

Currently Bref supported runtimes are 7.2 and 7.3.

You can change this by updating the layer reference in serverless.yml.

(PHP 7.2)
arn:aws:lambda:ap-southeast-2:209497400698:layer:php-72-fpm:14

(PHP 7.3)
arn:aws:lambda:ap-southeast-2:209497400698:layer:php-73-fpm:14

For a full list of supported PHP extensions and to configure more see Supported Extensions.

Environment variables can be added to the serverless.yml file.

For example:

provider:
  ...
  environment:
    DB_HOST: "production.db.rds.us-east-1.com"
    DB_DATABASE: "laravel"

Note: Secrets should be added to SSM secrets.

Laravel Serverless will take care of loading configuration and secrets from SSM at runtime. To do this you will need to provide APP_SECRETS_SSM_PATH in your serverless.yml enviroment:

provider:
  name: aws
  runtime: provided
  environment:
    APP_SECRETS_SSM_PATH: "/app/"

This will look for any parameters under /app/ and set them as an env.

For example:

/app/db_host becomes DB_HOST
/app/db_password becomes DB_PASSWORD
/app/DB_host becomes DB_HOST

• Laravel Vapor for source code inspiration.

Laravel Serverless is licensed under the MIT License.

All files located in the vendor and external directories are externally maintained libraries used by this software which have their own licenses; we recommend you read them, as their terms may differ from the terms in the MIT License.