Download the PHP package ostark/upper without Composer
On this page you can find all versions of the php package ostark/upper. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package upper
The pep pill for your Craft site
Upper speeds up Craft dramatically using a Cache Proxy in front of your webserver.
The Plugin adds the neccessary Cache-Control
and XKEY/Surrogate-Key/Cache-Tag
headers to your pages.
When Entries or Sections get updated in the Control Panel it takes care of the cache invalidation.
If you need an introduction to HTTP Caching, I highly recommend this article.
Sponsor
Development happens in my free time, but also during working hours. Thanks fortrabbit.com!
If you are looking additional integrations (Cache Drivers), feel free to contribute or raise an issue.
Supported Cache Drivers
- KeyCDN (CDN/SaaS)
- Fastly (CDN/SaaS)
- Cloudflare (CDN/SaaS)
- Varnish with XKEY support (your own proxy)
- Dummy (does nothing)
Installation
- Install with Composer via
composer require ostark/upper
from your project directory - Install plugin with this command
php craft plugin/install upper
or in the Craft CP under Settings > Plugins - A new configuration file gets generated automatically in
your-project/config/upper.php
.
Fastly Setup
KeyCDN Setup
Cloudflare Setup
By default, Cloudflare's CDN does not cache HTML content. You need to create a Cache Level: Cache Everything Page Rule to enable caching for "pages".
If you don't use Cloudflare Enterprise with native Cache-Tag
support, make sure to enable useLocalTags
in your config/upper.php
file (default), otherwise disable it.
You can generate a token in the Cloudflare dashboard. You want to create a custom token with the "Zone.Cache Purge" permission that is restricted to the DNS zone(s) you wish to clear Cloudflare's cache for.
Varnish Setup
Varnish URL supports multiple servers, separate with comma. E.g http://1.1.1.1,http://2.2.2.2
Tuning
In a template, you can fully disable caching like so:
…which is a shorthand for:
By default the defaultMaxAge
config setting will be used to determine the cache duration to set. This can be overridden in a template:
…which is shorthand for:
Performance results
Cache Tag Headers
Disclaimer
Even if the name of the plugin and some wordings are intentional, the author does not glorify any drug abuse. 🍻 The plugin is inspired by the joshangell/Falcon.