Download the PHP package douglasthwaites/oh-vapor without Composer

On this page you can find all versions of the php package douglasthwaites/oh-vapor. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package oh-vapor

OhVapor!

This package provides support for the use case of Laravel Vapor with the managed firewall (AWS WAF) enabled and the Oh Dear monitoring service.

Why?

When using OhDear to monitor your Laravel Vapor application if a firewall is enabled Vapor the OhDear is likely going to be blocked by the AWS WAF as automated traffic (which it is ;)).

Usually this would just mean whitelisting Oh Dear's IP addresses in the AWS WAF however in this case that will only work until your next vapor deploy at which point the firewall is completely reset removing the whitelisted IP's and OhDear will be blocked again.

Installation

composer require douglasthwaites/oh-vapor

Configuration

AWS access credentials with full WAF access only and your Oh Dear API key

WAF_AWS_ACCESS_KEY_ID=very
WAF_AWS_SECRET_ACCESS_KEY=secret
WAF_AWS_DEFAULT_REGION=stuff
OH_DEAR_API_KEY=here

There is also a publishable config file if you wish.

How does it work

To get around this limitation of two fantastic tools OhVapor has two commands, once which sets a maintenance period in Oh Dear and then another which re configures the AWS firewall to allow Oh Dear's IP's through.

Start maintenance command

Create a maintenance window in OhDear for x many seconds on y many site ID's:

php artisan oh-vapor:start-maintenance seconds siteId

Update WAF command

When reconfiguring the firewall OhVapor will reach out to get the lastest list of Oh Dear IP's and then create an IP set which is then applied to the WAF as a scope down statement applied to both the rate limit and bot control rules... i.e let em through ;)

It'll also use/reapply the current list of firewall rules in your vapor.yml

php artisan oh-vapor:update-waf environmentName

Where to call these command?

These commands can be called anytime but putting them in your CI/CD makes the most sense.

# Put Oh Dear site ID 12345 into maintenance mode for 5 minutes
php artisan oh-vapor:start-maintenance 300 12345

# Deploy to Vapor
vapor deploy production

# Allow Oh Dear through the firewall
php artisan oh-vapor:update-waf production

# Maintenance period ends and Oh Dear can check your app again :)

As long as the vapor deploy is quicker than your maintenance window you can dial it in till your hearts content.

Keep on keeping on!

All versions of oh-vapor with dependencies

PHP Build Version
Package Version
Requires php Version ^8.0
illuminate/support Version ^10.0
illuminate/console Version ^10.0
aws/aws-sdk-php Version ^3.295
symfony/yaml Version ^4.2|^5.0|^6.0
laravel/prompts Version ^0.1.15
ohdearapp/ohdear-php-sdk Version ^3.10
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package douglasthwaites/oh-vapor contains the following files

Loading the files please wait ....