PHPackages                             rtheunissen/guzzle-cache-handler - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [HTTP & Networking](/categories/http)
4. /
5. rtheunissen/guzzle-cache-handler

ActiveLibrary[HTTP & Networking](/categories/http)

rtheunissen/guzzle-cache-handler
================================

Guzzle 6/7 handler used to cache responses

v2.0.0(2y ago)12142.8k↓39%3MITPHPPHP >=7.2

Since Jun 5Pushed 7mo ago1 watchersCompare

[ Source](https://github.com/rtheunissen/guzzle-cache-handler)[ Packagist](https://packagist.org/packages/rtheunissen/guzzle-cache-handler)[ RSS](/packages/rtheunissen-guzzle-cache-handler/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (6)Versions (14)Used By (0)

Guzzle handler used to cache responses
======================================

[](#guzzle-handler-used-to-cache-responses)

[![Author](https://camo.githubusercontent.com/989b5323df87a6d4fe899296ec948ba333af9e04bbe23add7962dd26def71220/687474703a2f2f696d672e736869656c64732e696f2f62616467652f617574686f722d40727564695f746865756e697373656e2d626c75652e7376673f7374796c653d666c61742d737175617265)](https://twitter.com/rudi_theunissen)[![License](https://camo.githubusercontent.com/99f38a8e4e864a93bf6b82be32840a9df187cc344f1ca120b27ea8381e3f580c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f72746865756e697373656e2f67757a7a6c652d63616368652d68616e646c65722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/rtheunissen/guzzle-cache-handler)[![Latest Version](https://camo.githubusercontent.com/b61dd6fa8cf54267d2adca64febc317ac90a1237cfc59c96ebb1c8093e4b59b0/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f72746865756e697373656e2f67757a7a6c652d63616368652d68616e646c65722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/rtheunissen/guzzle-cache-handler)[![Build Status](https://camo.githubusercontent.com/bbc27de0111b09e9e199451bab53acc22b3e7fac0c294becdb975d0bc6998df1/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f72746865756e697373656e2f67757a7a6c652d63616368652d68616e646c65722e7376673f7374796c653d666c61742d737175617265266272616e63683d6d6173746572)](https://travis-ci.org/rtheunissen/guzzle-cache-handler)[![Scrutinizer](https://camo.githubusercontent.com/2e1513b301cc0d0455461adb8734d22bd8d4e447f83962898294ef4bb74c3566/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f72746865756e697373656e2f67757a7a6c652d63616368652d68616e646c65722e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/rtheunissen/guzzle-cache-handler/)[![Scrutinizer Coverage](https://camo.githubusercontent.com/c7c096f603334eca2e4fe94d7e9d9f65819b417c9f71cd197440e07daa237388/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f636f7665726167652f672f72746865756e697373656e2f67757a7a6c652d63616368652d68616e646c65722e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/rtheunissen/guzzle-cache-handler/)

Installation
------------

[](#installation)

```
composer require rtheunissen/guzzle-cache-handler
```

Usage
-----

[](#usage)

This is a handler which caches responses for a given amount of time.

You will need an implemented [CacheInterface](https://github.com/rtheunissen/cache/blob/master/src/CacheInterface.php). See [rtheunissen/cache](https://github.com/rtheunissen/cache) for more details.

```
use Concat\Http\Handler\CacheHandler;
use Doctrine\Common\Cache\FilesystemCache;
use GuzzleHttp\Client;

// Basic directory cache example
$cacheProvider = new FilesystemCache(__DIR__ . '/cache');

// Guzzle will determine an appropriate default handler if `null` is given.
$defaultHandler = null;

// Create a cache handler with a given cache provider and default handler.
$handler = new CacheHandler($cacheProvider, $defaultHandler, [

    /**
     * @var array HTTP methods that should be cached.
     */
    'methods' => ['GET', 'HEAD', 'OPTIONS'],

    /**
     * @var integer Time in seconds to cache a response for.
     */
    'expire' => 60,

    /**
     * @var callable Accepts a request and returns true if it should be cached.
     */
    'filter' => null,
]);

// Use a PSR-3 compliant logger to log when bundles are stored or fetched.
$handler->setLogger($logger);

// Create a Guzzle 6/7 client, passing the cache handler as 'handler'.
$client = new Client([
    'handler' => $handler
]);
```

###  Health Score

44

—

FairBetter than 92% of packages

Maintenance45

Moderate activity, may be stable

Popularity39

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

Top contributor holds 88.2% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~247 days

Recently: every ~728 days

Total

13

Last Release

1034d ago

Major Versions

v0.5.0 → v1.0.02015-08-11

v1.1.0 → v2.0.02023-07-19

PHP version history (3 changes)v0.0.1PHP >=5.4

v0.0.2PHP >=5.5

v2.0.0PHP >=7.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/761df764fa80c32031884a5dd2376cf7e70c0fa152eaa141fd68f12b4a761b9f?d=identicon)[rtheunissen](/maintainers/rtheunissen)

---

Top Contributors

[![rtheunissen](https://avatars.githubusercontent.com/u/809191?v=4)](https://github.com/rtheunissen "rtheunissen (45 commits)")[![antoniopaisfernandes](https://avatars.githubusercontent.com/u/6171197?v=4)](https://github.com/antoniopaisfernandes "antoniopaisfernandes (6 commits)")

---

Tags

httpGuzzlepsr7cachehandler

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/rtheunissen-guzzle-cache-handler/health.svg)

```
[![Health](https://phpackages.com/badges/rtheunissen-guzzle-cache-handler/health.svg)](https://phpackages.com/packages/rtheunissen-guzzle-cache-handler)
```

###  Alternatives

[kevinrob/guzzle-cache-middleware

A HTTP/1.1 Cache for Guzzle 6. It's a simple Middleware to be added in the HandlerStack. (RFC 7234)

43417.4M104](/packages/kevinrob-guzzle-cache-middleware)[rtheunissen/guzzle-log-middleware

Guzzle middleware to log requests and responses

842.3M17](/packages/rtheunissen-guzzle-log-middleware)[eljam/guzzle-jwt-middleware

A jwt authentication middleware for guzzle 6

28722.5k3](/packages/eljam-guzzle-jwt-middleware)[graham-campbell/guzzle-factory

Provides A Simple Guzzle Factory With Good Defaults

916.4M49](/packages/graham-campbell-guzzle-factory)[rtheunissen/guzzle-rate-limiter

Guzzle 6 middleware used to delay requests dynamically

52177.2k1](/packages/rtheunissen-guzzle-rate-limiter)[amphp/http-client-guzzle-adapter

Guzzle adapter for Amp's HTTP client.

1523.6k1](/packages/amphp-http-client-guzzle-adapter)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)