Building a Hybrid Cache System for Statamic
Minimum price
Suggested price

Building a Hybrid Cache System for Statamic

About the Book

Want to read this guide online? Feel free to check out this guide on my blog

Source Code: The source code is freely available, released under the MIT license. You can grab it on GitHub at

This step-by-step guide covers implementing a custom cache system for Statamic, which provides near-static cache response times while preserving some of the text-editor workflows that make Statamic great. Learn about some interesting Statamic internals and fantastic Laravel features along the way! 

Topics covered throughout this guide include:

  • Working with Statamic's Stache repositories to query entries, assets, and taxonomy terms
  • Overriding Statamic's data classes to add custom features and behaviors
  • Custom service providers, Artisan commands, and facades
  • Tracking request content dependencies, including assets and global variables
  • Leveraging Laravel view composers to track request template dependencies
  • Utilizing Laravel's service container to interact with different classes throughout the application lifecycle
  • Developing custom Antlers tags
  • Unencrypted Laravel cookies and automatic cache bypass

About the Author

Johnathon Koster
Johnathon Koster

Hello, internet!

My name is John, and I have over fifteen years of professional software development. I've worked on a wide range of projects over the years, from simple websites and critical government reporting applications all the way to high-performance telematics solutions.

During my downtime, I enjoy working on open-source projects, writing posts on my blog, and contributing to the Laravel and Statamic ecosystems.

Some of the recent open-source projects I've worked on include:

  • blade-parser-typescript - a Laravel Blade parser, formatter, reflection library, and linter, written in TypeScript
  • Antlers Toolbox - a Visual Studio Code extension providing syntax highlighting, code auto-complete, intelligent refactoring, and project-aware assistance for Statamic developers
  • Antlers Runtime - an advanced PHP templating engine for the Statamic CMS platform
  • Proteus - a Laravel package that makes it simple to read, write, and modify Laravel configuration files from your application code
  • Primitives - a PHP library that safely parses input strings into native PHP types (string, bool, arrays, etc.) and can optionally be configured with a sandbox for method evaluation

Table of Contents

  • 1. Introduction
    • 1.1 What We’re Going to Build
    • 1.2 Experimenting with Response Times
  • 2. Experimentation and Cache Design
  • 3. Organization, Singletons, and Facades
  • 4. Invalidating the Cache When Templates Change
  • 5. Detecting Request Dependencies
  • 6. Managing Cached Response Headers
  • 7. Making Our Cache Configurable and Excluding Items from the Cache
  • 8. Bypassing the Cache
  • 9. Setting Cache Expiration Times
  • 10. Invalidating All Cached Responses
  • 11. Labeling Cached Content
    • 11.1 Modifying Statamic Tags to Help Populate Namespaces and Labels
    • 11.2 Invalidating Labels Using Event Listeners
    • 11.3 Adding Cache Namespace Label Support to Our Antlers Tag
      • Invalidating Custom Labels
  • 12. Cache Reporting and Stats
  • 13. Invalidating Cached Laravel Route Responses
  • 14. Excluding Pages with CSRF Tokens
  • 15. Torchlight Syntax Highlighting and Cache Management

The Leanpub 60 Day 100% Happiness Guarantee

Within 60 days of purchase you can get a 100% refund on any Leanpub purchase, in two clicks.

Now, this is technically risky for us, since you'll have the book or course files either way. But we're so confident in our products and services, and in our authors and readers, that we're happy to offer a full money back guarantee for everything we sell.

You can only find out how good something is by trying it, and because of our 100% money back guarantee there's literally no risk to do so!

So, there's no reason not to click the Add to Cart button, is there?

See full terms...

80% Royalties. Earn $16 on a $20 book.

We pay 80% royalties. That's not a typo: you earn $16 on a $20 sale. If we sell 5000 non-refunded copies of your book or course for $20, you'll earn $80,000.

(Yes, some authors have already earned much more than that on Leanpub.)

In fact, authors have earnedover $13 millionwriting, publishing and selling on Leanpub.

Learn more about writing on Leanpub

Free Updates. DRM Free.

If you buy a Leanpub book, you get free updates for as long as the author updates the book! Many authors use Leanpub to publish their books in-progress, while they are writing them. All readers get free updates, regardless of when they bought the book or how much they paid (including free).

Most Leanpub books are available in PDF (for computers) and EPUB (for phones, tablets and Kindle). The formats that a book includes are shown at the top right corner of this page.

Finally, Leanpub books don't have any DRM copy-protection nonsense, so you can easily read them on any supported device.

Learn more about Leanpub's ebook formats and where to read them

Write and Publish on Leanpub

You can use Leanpub to easily write, publish and sell in-progress and completed ebooks and online courses!

Leanpub is a powerful platform for serious authors, combining a simple, elegant writing and publishing workflow with a store focused on selling in-progress ebooks.

Leanpub is a magical typewriter for authors: just write in plain text, and to publish your ebook, just click a button. (Or, if you are producing your ebook your own way, you can even upload your own PDF and/or EPUB files and then publish with one click!) It really is that easy.

Learn more about writing on Leanpub