[ryanmitchell]

Why

Every tracked URL lived in one serialized array under tracker::urls. On a site with ~11k URLs that's a 13+ MB value, and:

• every GET reaching the middleware read the whole thing for one has() check
• every tracked render read it twice and rewrote all of it
• every invalidation scanned every URL and rewrote all of it
• concurrent writes overwrote each other, so URLs dropped out of tracking and went stale in the static cache
• on Redis, each large GET or SET held up every other command on that Redis while it ran

What

Storage goes through a small Store interface with two implementations, picked automatically from the static cache store. There's no new config.

• RedisStore (when the store is Redis): one hash of URL records plus one set per tag. Commands touch a single key, so it works on Redis Cluster, and writes are pipelined.
• CacheStore (any other Laravel cache store): one key per URL, a URL index split across 256 keys, and one key per tag listing its URLs. Writes to those shared keys are locked. Leftover entries in a tag's list are checked and removed at lookup time.

Existing tracker::urls data is moved over automatically on first use, behind a lock so only one process does it.

The public Tracker API is unchanged. This also adds Tracker::findByTags(), which GetUrlsController now uses instead of scanning everything.

Why two drivers: the generic driver alone fixes reads and invalidation. Tracking a page, though, has to lock, read and rewrite the URL list of each tag used on nearly every page (globals, navs, partials). After a global or nav save invalidates the whole site, a re-warm queues every render on those locks. Redis adds a URL to a set (SADD) in a single call with no lock.

Numbers

11,218 URLs, 30 tags each, local Redis (no network time):

	Old single key	Redis driver	Cache driver
has()	14.1 ms	0.02 ms	0.02 ms
add()	23.4 ms	0.07 ms	10.3 ms
invalidate one tag (42 URLs)	27.1 ms	0.14 ms	0.15 ms
wildcard invalidate (all URLs)	27 ms	30 ms	32 ms
one-off migration	n/a	0.2 s	2.7 s

Notes

• Wildcard tag invalidation still checks every URL, same as before. The addon never issues wildcard tags itself.
• cache-tracker:list now sorts by URL, since all() order is no longer the order URLs were added.
• Fixed it_doesnt_track_pages_already_in_the_manifest. It tracked / while the middleware tracks http://localhost, so it only passed because of array ordering.

Testing

• New tests/Unit/StoreTest.php runs against both drivers. It covers stale tags, wildcards, import, flush and migration. The Redis cases are skipped when Redis isn't available.
• CACHE_TRACKER_TEST_REDIS=1 vendor/bin/pest runs the whole suite against Redis (it uses db 15).
• The full suite passes on both: 59 tests each.

🤖 Generated with Claude Code