# Core: Caching

> Per-stream cache config, criteria cache(), fresh(), and flush on writes.

Source: https://streams.dev/docs/core/caching

Core caches criteria results per stream when enabled. Cache keys are prefixed with `streams.{handle}.` via `Streams\Core\Stream\StreamCache`.

## Stream config

```json
{
    "config": {
        "cache": {
            "enabled": true,
            "ttl": 3600,
            "store": "redis"
        }
    }
}
```

| Key | Purpose |
|-----|---------|
| `enabled` | Auto-cache `get()` and `count()` on criteria |
| `ttl` | Default seconds for query cache |
| `store` | Laravel cache store name |

## Query cache

```php
// Explicit TTL and optional key
Streams::entries('posts')->cache(600, 'posts.published')->get();

// Bypass cache for one query
Streams::entries('posts')->fresh()->get();
```

## Stream-level remember

```php
Streams::make('posts')->cache()->remember('meta', 3600, fn () => ...);
```

## Flush behavior

These operations flush the stream cache:

- `Criteria::create()`
- `$entry->save()` through criteria/repository
- `$entry->delete()`
- `truncate()`

## Related

- [Criteria](/docs/core/criteria)
- [Hub: Caching](/docs/caching)