Download the PHP package poing/laravel-elb without Composer
On this page you can find all versions of the php package poing/laravel-elb. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download poing/laravel-elb
More information about poing/laravel-elb
Files in poing/laravel-elb
Package laravel-elb
Short Description Essentials for Laravel on AWS Elastic Beanstalk with HTTPS
License MIT
Informations about the package laravel-elb
Running Laravel on AWS Elastic Beanstalk with HTTPS
This package provides the essential elements for a Laravel app running on AWS Elastic Beanstalk (ELB)
with HTTPS.
It provides the following:
- Environment Configuration Files
.ebextensions
for Deployment- Set the document root to
/public
- Example showing how to read environment configuration variables
- Copy
.env.aws
to.env
- Run
artisan
commands - How to install and run
npm
commands
- Set the document root to
defaultStringLength()
for MariaDB or Auroa- Middleware for HTTP to HTTPS redirection
- Includes the ability to configure exceptions to the HTTPS redirection
- Middleware to recognize secure requests
Elastic Beanstalk with HTTPS Quick Start Guide
Here are Step-by-Step instructions to deploy a new Laravel application to AWS Elastic Beanstalk.
Installation
You can install this package using composer
Commands:
Once the package is installed, the following artisan
commands will be available in your Laravel application:
elb:install
: Add.ebextensions
directory and.env.aws
to the Laravel application.elb:publish
: Addconfig/laravel-elb.php
to the Laravel application, to allow HTTPS redirection customization.- This will disable the sample
route
andview
included with the package.
- This will disable the sample
Elastic Beanstalk Configuration Files
This package provides Elastic Beanstalk configuration files (.ebextensions) to configure the environment, customize AWS resources, and perform Laravel tasks. Like running artisan
commands.
These provide the basic requirements for deploying Laravel to Elastic Beanstalk. Files are named so you can insert files within the processing order.
If you think something is missing, something could be done better, feel free to submit a pull request.
Except forHTTP
toHTTPS
redirect, see the next section for an explanation.
MariaDB or Auroa
Because I often use Auroa or MarieDB, instead of MySQL. I added the fix for non-MySQL Databases.
Laravel 5.4 made a change to the default database character set, and it’s now utf8mb4 which includes support for storing emojis. This only affects new applications and as long as you are running MySQL v5.7.7 and higher you do not need to do anything.
While AWS does provide a higher version of MySQL. Aurora (MySQL Compatabe), does not support the increased string length. yet
HTTP to HTTPS Redirection
Middleware included in this package eliminates the necessity of using .ebextensions
to handle HTTP
to HTTPS
redirection with the Apache RewriteEngine
method. While allowing some traffic not to be redirected, such as the Elastic Beanstalk HealthChecker.
Redirection does not occur for any of the following conditions:
- The
User-Agent
is the Elastic Beanstalk HealthChecker - The Application Environment
APP_ENV
is set tolocal
- The
URI
matches theexclude
configuration settings
It provides the same functionality as the https-redirect
recommended in the AWS documentation, and allows for custom paths to easily be excluded.
You may choose to use the .ebextensions
method, it should not affect this middleware.
The middleware is a result of frustration trying to get the correct
RewriteCond
rules to exclude multiple conditions using the.ebextensions
method. Handling theHTTP
toHTTPS
redirection with Laravel provides more flexibility with less headaches. I was working with an application that could not fetch content from third party domains with HTTPS.
- This package does not prevent
HTTPS
access. - It does not redirect
HTTPS
toHTTP
. - It only allows
HTTP
access to the specifiedURI
paths.
Basic Usage
By default, this package includes a sample view
and allows HTTP
access to URI
's with a base of /unsecure
.
Configuration
To use your own configuration, run elb:publish
to install config/laravel-elb.php
in your Laravel application.
This will disable the sample
view
included with the package.
Excluded URI Paths
exclude
: An array ofURI
paths that are not redirected toHTTPS
.- Empty array will redirect all
HTTP
toHTTPS
.
- Empty array will redirect all
Behaviour:
Strict Mode
strict
: Boolean setting that will limit the path to only those specified in theexclude
setting.
Behaviour:
Recognizing Secure Requests
The AWS Elastic Beanstalk environment uses a Load Balancer to serve HTTPS
requests, while the Laravel application actually runs in an AWS Elastic Beanstalk environment that only supports HTTP
.
This can cause the Laravel application to represent HTTP
to helper methods that return URL
information, since the Laravel application is not aware of the Load Balancer.
Incorrect Response:
This package uses peppeocchi/laravel-elb-middleware
to simplify using HTTPS
with your Laravel application on AWS Elastic Beanstalk. Ensuring that your Laravel application will correctly recognize secure requests when running on Elastic Beanstalk with a Load Balancer. Allowing helper methods that return URL
information, to represent the correct protocol scheme
.
Correct Response:
This middleware is based on a gist by Giuseppe Occhipinti that does the exact same thing.