Caching

Data caching

The data library automatically caches all query results in ext/data/.tmp/cache/. The cache is invalidated when a record in the queried resource is saved, added or removed, by the site, the API, Git or ext:sync, and when its .meta is edited. No manual cache management is needed for any of those.

One case is not seen: a record file edited in place by hand (an editor that writes into the existing file). A cached list shows the old values until the next write to that resource. Clear the cache after such an edit:

./nimbly data:cache:clear

The admin dashboard has the same action, Clear data cache.

---

data:cache:clear

Throws away the cached query results of every resource; the next read builds them again. Use this after editing a record file in place by hand (see Data caching). Saving through the site, the API, Git or ext:sync needs no clearing.

php core/cli/nimbly.php data:cache:clear