Download the PHP package area17/edge-flush without Composer
On this page you can find all versions of the php package area17/edge-flush. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download area17/edge-flush
More information about area17/edge-flush
Files in area17/edge-flush
Package edge-flush
Short Description CDN Cache Control and Invalidation
License MIT
Homepage https://github.com/area17/edge-flush
FAQ
Example:
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 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.
Informations about the package edge-flush
EdgeFlush
EdgeFlush is Laravel package intended to help developers manage CDN granular caching and invalidations. Having Akamai, CloudFront (or any other CDN) in front of a website, data modification usually forces us to bust the whole cache, leading to a website slow (for the first users) until the whole cache is rebuilt, and if the "first user" is Google Bot, for example, this can also impact on your website's rank. This pacakge aims to do invalidations granularly.
Feature list
- Granular invalidation: this package will create a collection of all models that impacts one page and when one of those models change, all pages that had that model rendered in previous requests will be purged from CDN.
- Granular control of Cache-Control headers: you will be able to configure it differently per request, telling the CDN to store some pages for one week and others for 5 seconds, for example.
- Single Akamai Edge Cache Tag relating to all models touched by a page render.
- Define different strategies for Cache-Control: web pages may have a different cache strategy than api endpoints.
- Prevents from caching pages containing forms.
- Caches only frontend pages, leaving the CMS uncashed, if needed.
- Re-warm pages purged from cache.
- Strip cookies from cachable responses.
- Disable caching for some pages using a middlware.
- Define HTTP methods that allow caching or not: cache GET but not POST.
- Define HTTP response status codes that allow caching or not: Cache 200 and 301 but not 400+ status codes.
- Define what routes can and cannot be cached by CDN.
- Define what type of responses can be cached: cache Response but not JsonResponse, for example.
- Define what Model classes can be cached or not.
- Remember what pages have been cached and command your CDN service to burst only those when you save something on your backend.
- Supports CloudFront invalidations.
- Supports Akamai EdgeCacheTags invalidations.
- Allow override of Services and easy implementation to support new CDN Services.
- Spatie's Laravel Response Cache granular invalidations.
Installation
Install the package via composer:
Publish the config file with:
And run the migrations:
Dependencies
The supported CDN services have these package dependencies that you need to choose according to your setup:
Akamai: akamai-open/edgegrid-auth CloudFront: aws/aws-sdk-php
Usage
Do a full read on the config/edge-flush.php there's a lot of configuration items and we tried to document them all.
Define your CDN service class on config/edge-flush.php:
Add the trait A17\EdgeFlush\Behaviours\CachedOnCDN to your models and repositories.
Call $this->invalidateCDNCache($model) every time a model (on your base model or repository save() method). This example takes in consideration Twill's repositories:
Call $this->cacheModelOnCDN($model) method on model's getAttribute():
Add the Middlware to the Kernel.php file:
Cache-Control max-age and s-maxage is set automatically, but if you need to change it depending on the current request you can use the following method:
If you want to invalidate your paths in batches, add a scheduler setting the desired frequency for this to happen:
You need to enable the package and the warmer on your .env file
CDN third-party service configuration
Please check the respective environment variables needed for supported services to work:
Rewarming cache
Purged cache pages can load slowly for the next users or even Google Bot, if you want to prevent this you can enable (on config) the cache warmer and add the job to the schedule:
Note that the most hit (or frequently updated) pages will be warmed first.
Akamai Edge Cache Tags
Akamai has a 128 bytes limit for the tag list, so if one page is impacted by lots of models, we would have no other way than busting the whole cache every time. This package creates a single Edge Cache Tag that relates to all models touched when the page was rendered, and adds it yo the response header:
Invalidating the full cache from the command line
In case you need to invalidate the whole CDN cache locally or on a deployment routing, you can:
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security Vulnerabilities
Please review our security policy on how to report security vulnerabilities.
Credits
- AREA 17
- All Contributors
License
The MIT License (MIT). Please see License File for more information.
