SKE Laravel bridge

ske-io/laravel-bridge runs a Laravel application on SKE, which deploys it into your own AWS or GCP account. It connects the application's HTTP requests, queued jobs, commands and scheduler to the platform.

Requirements

• PHP 8.3 or later
• Laravel 11, 12 or 13

Installation

composer require ske-io/laravel-bridge

Laravel discovers the service provider, so there is nothing to register or configure. Off the platform the bridge stays inactive, apart from the upload endpoint, so the same application runs locally as before.

On AWS, the platform's queue connection sends jobs to SQS through the AWS SDK, which the bridge doesn't require. Install it if the application doesn't have it yet:

composer require aws/aws-sdk-php

What it does on the platform

• Queues: adds the ske queue connection (SQS on AWS, Cloud Tasks on GCP) and runs the jobs the platform delivers, recording failures in the application's failed jobs store.
• Logs: writes logs to stderr, one JSON line per record, so the platform's log viewer shows level, message, context and exception.
• Proxies: trusts the platform's load balancer, so the request's scheme, host and client address are the real ones.
• AWS credentials: lets the AWS SDK use the function role's temporary credentials. A key pair the application sets itself still wins.
• Mail: sends SES mail from the region of the mail provider linked to the environment.
• Maintenance mode: follows the maintenance mode set in the SKE dashboard. See Maintenance mode.
• Encrypted environment file: loads the environment's .env.{environment}.encrypted when its key is set. See Encrypted environment file.
• Inertia SSR: when SSR is turned on for the environment, sends Inertia's render calls to the platform's SSR server. This needs inertiajs/inertia-laravel.

Documentation

• Laravel on SKE
• Direct uploads
• Encrypted environment file
• Maintenance mode

Development

composer install
vendor/bin/pint --test
vendor/bin/phpstan analyse
vendor/bin/pest

License

The MIT License. See LICENSE.