PHPackages                             serfe/module-uncacheableblockdetector - 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. [Caching](/categories/caching)
4. /
5. serfe/module-uncacheableblockdetector

ActiveMagento2-module[Caching](/categories/caching)

serfe/module-uncacheableblockdetector
=====================================

Detects blocks that are uncacheable inside your Magento 2 system

1.2.0(1y ago)41332GPL-3.0PHPPHP 7.\*|^8.1

Since Jul 31Pushed 1y ago3 watchersCompare

[ Source](https://github.com/Serfe/magento2-uncached-blocks-detector)[ Packagist](https://packagist.org/packages/serfe/module-uncacheableblockdetector)[ RSS](/packages/serfe-module-uncacheableblockdetector/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (3)Versions (3)Used By (0)

Serfe Uncached Blocks Detector - Magento 2
==========================================

[](#serfe-uncached-blocks-detector---magento-2)

[![Latest Stable Version](https://camo.githubusercontent.com/5bf1f6a82f3e86a2c8d47a439fe3cf40739fd9be83d87a1a576b272e4c8de2cb/68747470733a2f2f706f7365722e707567782e6f72672f73657266652f6d6f64756c652d756e636163686561626c65626c6f636b6465746563746f722f76)](https://packagist.org/packages/serfe/module-uncacheableblockdetector) [![Total Downloads](https://camo.githubusercontent.com/88e7982e55fc3809d9ad439af184d31148ab2d34ec6656596cf9fe5a7e2a9582/68747470733a2f2f706f7365722e707567782e6f72672f73657266652f6d6f64756c652d756e636163686561626c65626c6f636b6465746563746f722f646f776e6c6f616473)](https://packagist.org/packages/serfe/module-uncacheableblockdetector) [![License](https://camo.githubusercontent.com/b89400e19d38df334eb32ec7e7990d202e041e6904e1a8b6a8e72e9f1092b8ae/68747470733a2f2f706f7365722e707567782e6f72672f73657266652f6d6f64756c652d756e636163686561626c65626c6f636b6465746563746f722f6c6963656e7365)](https://packagist.org/packages/serfe/module-uncacheableblockdetector) [![PHP Version Require](https://camo.githubusercontent.com/b94dc0fb68b9d129fd6c5ffc26017fc64f6de3dc8cd177a86d39b4e0806652d4/68747470733a2f2f706f7365722e707567782e6f72672f73657266652f6d6f64756c652d756e636163686561626c65626c6f636b6465746563746f722f726571756972652f706870)](https://packagist.org/packages/serfe/module-uncacheableblockdetector)

The propouse of this module is to intercept the normal workflow of page rendering of Magento 2 and force the exit the rendering of the page if a block that is uncacheable is reached. If the block is uncacheable, the wholepage get it's cache disabled and cannot be handled by file cache or Varnish cache.

This is usefull to debug any module that might contain the following entry inside one of it's layout definitions (catalog\_product\_view.xml for example):

```
  ....

  ....
```

In which cases you will see this module required?
-------------------------------------------------

[](#in-which-cases-you-will-see-this-module-required)

This module is good to help troubleshoot when your any page of the system is not having it's cache generated by Magento (in Varnish or in Disk Cache) and you don't know which is the block that is making this behaviour to happen.

Just install this module as developer dependency and configure it from the console or inside the developer section in the backend admin, refresh and see the block name popup as an error on your frontend section.

This only works on development mode. On production mode, this module auto-disable itself to avoid possible issues.

Install
-------

[](#install)

```
composer install serfe/module-uncheableblockdetector --dev
```

```
php bin/magento setup:upgrade
```

Configuration
-------------

[](#configuration)

The module allow to enable or disable the feature on the backend section when in developer mode.

Go into Backend &gt; Stores &gt; Configuration &gt; Advanced &gt; Developer &gt;

### Using the console

[](#using-the-console)

If you want to have the setup been done using the console, run the following commands:

Enable the module detection with:

```
php bin/magento config:set --lock-env dev/cache_detector/enabled 1
```

To disable the exception throwing on the first block detected:

```
php bin/magento config:set --lock-env dev/cache_detector/die 0
```

When using this last option, you will see the detected entries into the debug.log file.

About Us
--------

[](#about-us)

[Serfe](https://www.serfe.com/?utm_medium=referral_profile&utm_source=github&utm_campaign=115959) develops complete e-commerce solutions based on Magento 2 system and other platforms. Feel free to check it on the website.

### Contributing

[](#contributing)

We welcome any contribution to this module. Fork the repo, make your changes and create a pull request with your changes.

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance35

Infrequent updates — may be unmaintained

Popularity17

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 63.6% 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 ~5 days

Total

2

Last Release

651d ago

PHP version history (2 changes)1.0.0PHP \*

1.2.0PHP 7.\*|^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/36e5ddafa943e9e978ab75c3fcd52ee282d0a9d2589233d1583fa505b0088e6d?d=identicon)[Serfe-com](/maintainers/Serfe-com)

---

Top Contributors

[![esteban-serfe](https://avatars.githubusercontent.com/u/26123716?v=4)](https://github.com/esteban-serfe "esteban-serfe (7 commits)")[![Serfe-com](https://avatars.githubusercontent.com/u/153220375?v=4)](https://github.com/Serfe-com "Serfe-com (4 commits)")

---

Tags

adobe-commercecachemodule

### Embed Badge

![Health badge](/badges/serfe-module-uncacheableblockdetector/health.svg)

```
[![Health](https://phpackages.com/badges/serfe-module-uncacheableblockdetector/health.svg)](https://phpackages.com/packages/serfe-module-uncacheableblockdetector)
```

###  Alternatives

[fastly/magento2

Fastly CDN Module for Magento 2.4.x

1564.2M1](/packages/fastly-magento2)[lizardmedia/module-varnish-warmer

Varnish Cache Warmer Magento2 module by Lizard Media

6276.8k](/packages/lizardmedia-module-varnish-warmer)[litespeed/module-litemage

LiteMage Full Page Cache for LiteSpeed Web Server

3254.8k](/packages/litespeed-module-litemage)[elgentos/magento2-varnish-extended

This extension extends the built-in Varnish functionalities

6510.9k](/packages/elgentos-magento2-varnish-extended)[vendic/module-optimize-cache-size

Magento 2 extension that reduces the number of cache keys by removing catalog\_product\_view\_id\_, catalog\_product\_view\_sku\_, catalog\_product\_view\_attribute\_set\_, catalog\_category\_view\_id\_ layout handles by default

3453.6k](/packages/vendic-module-optimize-cache-size)[redchamps/module-easy-cache-clean

Clean invalidated cache(s) easily in a Magento 2 store

2838.0k](/packages/redchamps-module-easy-cache-clean)

PHPackages © 2026

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