Sidecar packages, deploys, and executes AWS Lambda functions from your Laravel application.

Published on by

Sidecar packages, deploys, and executes AWS Lambda functions from your Laravel application. image

Sidecar is a package by the Hammerstone team that takes the pain out of the packaging, deploying, and executing of AWS Lambda functions from your Laravel application.

Sidecar supports both Laravel 7 and 8 and requires PHP 7.2 or newer.

Laravel Vapor brought the power of serverless to Laravel. Using Vapor, you can run your plain ol' Laravel apps on a serverless platform and get incredible speed, security, and reliability.

Sidecar brings the ease of Vapor to non-PHP functions. Common use cases could be taking screenshots with headless Chrome, running FFmpeg, doing some data work with Python, generating images, or rendering your Javascript frontend server-side.

Or maybe you want to run a single Ruby script without configuring Ruby on your server. Or Java. Or even Powershell for some reason?

You can use any of the runtimes supported by Lambda:

  • Node.js 14
  • Node.js 12
  • Node.js 10
  • Python 3.8
  • Python 3.7
  • Python 3.6
  • Python 2.7
  • Ruby 2.7
  • Ruby 2.5
  • Java 11
  • Java 8
  • Go 1.x
  • .NET Core 3.1
  • .NET Core 2.1

Sidecar comes with a sidecar:configure command that interactively walks you through setting up the correct permissions in AWS so that you don't have to mess around in the IAM UI.

Once you have your credentials configured, making your first Lambda requires only two things:

  • A PHP class
  • The files you want to be deployed to Lambda

Let's assume we're going to use Node to generate an image. Your function class could look like this:

namespace App\Sidecar;
 
use Hammerstone\Sidecar\LambdaFunction;
 
class GenerateImage extends LambdaFunction
{
public function handler()
{
// Define your handler function.
// (Javascript file + export name.)
return 'resources/lambda/image.handler';
}
 
public function package()
{
// All files and folders needed for the function.
// In this case some JS files and some fonts.
return [
'resources/lambda',
'resources/fonts',
];
}
}

With your function configured, you can deploy and activate it with a simple command:

php artisan sidecar:deploy --activate

The above command creates your Lambda function on AWS and prepares it for use.

You can execute this function anywhere in your Laravel application simply by calling execute on the class, passing any data you want to the Lambda function.

$image = GenerateImage::execute([
'text' => 'This image was generated on Lambda!'
]);

This article is a very brief overview of what Sidecar can do. Sidecar also handles:

  • Separate environments
  • Async execution
  • Multiple, concurrent async execution
  • Configurable memory, timeout, and runtime per function
  • Separate deploy and activate steps for zero downtime or version drift
  • Retrieving logs and timings per execution
  • Returning Lambda execution results directly to the browser as Laravel responses

To read the full documentation see https://hammerstone.dev/sidecar/docs or visit the GitHub repository at https://github.com/hammerstonedev/sidecar.

Please note that this is a v0.1.0 release. Issues are being addressed quickly, and features are being added as they move towards a 1.0 release. Feel free to reach out to the author directly on Twitter at twitter.com/aarondfrancis.

Aaron Francis photo

Writing and tweeting about building products + Laravel.

Working on torchlight.dev & hammerstone.dev.

Dad to boy/girl twins.

Cube

Laravel Newsletter

Join 40k+ other developers and never miss out on new tips, tutorials, and more.

image
No Compromises

Joel and Aaron, the two seasoned devs from the No Compromises podcast, are now available to hire for your Laravel project.

Visit No Compromises
Laravel Forge logo

Laravel Forge

Easily create and manage your servers and deploy your Laravel applications in seconds.

Laravel Forge
Tinkerwell logo

Tinkerwell

The must-have code runner for Laravel developers. Tinker with AI, autocompletion and instant feedback on local and production environments.

Tinkerwell
No Compromises logo

No Compromises

Joel and Aaron, the two seasoned devs from the No Compromises podcast, are now available to hire for your Laravel project. ⬧ Flat rate of $7500/mo. ⬧ No lengthy sales process. ⬧ No contracts. ⬧ 100% money back guarantee.

No Compromises
Kirschbaum logo

Kirschbaum

Providing innovation and stability to ensure your web application succeeds.

Kirschbaum
Shift logo

Shift

Running an old Laravel version? Instant, automated Laravel upgrades and code modernization to keep your applications fresh.

Shift
LoadForge logo

LoadForge

Easy, affordable load testing and stress tests for websites, APIs and databases.

LoadForge
Paragraph logo

Paragraph

Manage your Laravel app as if it was a CMS – edit any text on any page or in any email without touching Blade or language files.

Paragraph
Lucky Media logo

Lucky Media

Bespoke software solutions built for your business. We ♥ Laravel

Lucky Media
Lunar: Laravel E-Commerce logo

Lunar: Laravel E-Commerce

E-Commerce for Laravel. An open-source package that brings the power of modern headless e-commerce functionality to Laravel.

Lunar: Laravel E-Commerce
Bacancy - Staff Augmentation logo

Bacancy - Staff Augmentation

Leave your web app development hustles to the leading IT Staff Augmentation Service Providers. Choose from an extensive pool of 1050+ developers and give yourself the sigh of success you deserve with Bacancy. Get In Touch Today!

Bacancy - Staff Augmentation
DocuWriter.ai logo

DocuWriter.ai

Save hours of manually writing Code Documentation, Comments & DocBlocks, Test suites and Refactoring.

DocuWriter.ai
Rector logo

Rector

Your partner for seamless Laravel upgrades, cutting costs, and accelerating innovation for successful companies

Rector

The latest

View all →
October CMS v3.6 Ships Today, Full of New Features image

October CMS v3.6 Ships Today, Full of New Features

Read article
Laracon EU Videos are now out image

Laracon EU Videos are now out

Read article
Use Google's Gemini AI in Laravel image

Use Google's Gemini AI in Laravel

Read article
PhpStorm is getting a brand new terminal image

PhpStorm is getting a brand new terminal

Read article
Six Essential Plugins for Visual Studio Code image

Six Essential Plugins for Visual Studio Code

Read article
Modularize Your Laravel Application With the Modular Package image

Modularize Your Laravel Application With the Modular Package

Read article