# Cache

Como funciona o cache de recursos e quando ele é invalidado.

## Cache de dados

A biblioteca de dados guarda automaticamente em cache todos os resultados de consultas em `ext/data/.tmp/cache/`. O cache é invalidado quando um registro do recurso consultado é salvo, adicionado ou removido, pelo site, pela API, pelo Git ou pelo `ext:sync`, e quando o `.meta` dele é editado. Em nenhum desses casos é preciso gerenciar o cache à mão.

Um caso não é percebido: um arquivo de registro editado à mão no próprio lugar (um editor que grava no arquivo existente). Uma lista em cache mostra os valores antigos até a próxima gravação nesse recurso. Limpe o cache depois de uma edição assim:

```bash
./nimbly data:cache:clear
```

O painel do admin tem a mesma ação, `Clear data cache`.

---

## `data:cache:clear`
Descarta os resultados de consultas em cache de todos os recursos; a próxima leitura os reconstrói. Use depois de editar à mão um arquivo de registro no próprio lugar (veja Cache de dados). Salvar pelo site, pela API, pelo Git ou pelo `ext:sync` não exige limpeza.

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