, (*1)
DEPRECATED
This Craft CMS 2.x plugin is no longer supported, but it is fully functional, and you may continue to use it as you see fit. The license also allows you to fork it and make changes as needed for legacy support reasons., (*2)
The Craft CMS 3.x version of this plugin can be found here: craft-fastcgicachebust and can also be installed via the Craft Plugin Store in the Craft CP., (*3)
FastCGI Cache Bust plugin for Craft CMS
Bust the Nginx FastCGI Cache when entries are saved or created., (*4)
Related: FastCGI Cache Bust for Craft 3.x, (*5)
Installation
To install FastCGI Cache Bust, follow these steps:, (*6)
- Download & unzip the file and place the
fastcgicachebust
directory into your craft/plugins
directory
- -OR- do a
git clone https://github.com/nystudio107/fastcgicachebust.git
directly into your craft/plugins
folder. You can then update it with git pull
- -OR- install with Composer via
composer require nystudio107/fastcgicachebust
- Install plugin in the Craft Control Panel under Settings > Plugins
- The plugin folder should be named
fastcgicachebust
for Craft to see it. GitHub recently started appending -master
(the branch name) to the name of the folder for zip file downloads.
FastCGI Cache Bust works on Craft 2.5.x and Craft 2.6.x., (*7)
FastCGI Cache Bust Overview
FastCGI Cache Bust is a simple plugin that clears your entire FastCGI Cache any time an entry is saved. This is somewhat of a scortched earth approach to cache invalidation, but it ensure cache coherency., (*8)
Check out the article Static Page Caching with Craft CMS for details on how to set up FastCGI Cache on your website., (*9)
Configuring FastCGI Cache Bust
Click on the gear icon next to the plugin to configure it by adding the full absolute path to your Nginx FastCGI Cache directory. If you require more than one FastCGI Cache directory cleared, separate the paths with a comma (,
)., (*10)
Using FastCGI Cache Bust
FastCGI Cache Bust listens for elements being saved, and busts the entire FastCGI Cache automatically when that happens., (*11)
You can also manually clear the FastCGI Cache via Craft's 'Clear Caches' tool, (*12)
FastCGI Cache Bust Roadmap
Some things to do, and ideas for potential features:, (*13)
- We could invalidate only affected caches onElementSave instead of the entire cache
Brought to you by nystudio107, (*14)