Skip to content

Commit a6025ee

Browse files
committed
Clarify that audit is disabled by default and must be explicitly enabled in the blameable options.
1 parent 1ecd438 commit a6025ee

1 file changed

Lines changed: 6 additions & 2 deletions

File tree

resources/skills/phalconkit-app-developer/references/model-behaviors.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -212,8 +212,8 @@ core interfaces.
212212
Runtime toggles can disable parent audit rows or detail rows for imports,
213213
migrations, or hot paths. Keep such toggles local to the operation.
214214

215-
Audit is opt-in by default. Applications that install and use the audit tables
216-
should enable audit in the model `blameable` options:
215+
Audit is disabled by default. Applications that want audit rows should opt in,
216+
usually through the model `blameable` options:
217217

218218
```php
219219
[
@@ -227,6 +227,10 @@ Applications that do not install audit tables can omit this option. If audit is
227227
enabled while the audit tables are absent, PhalconKit treats the missing audit
228228
storage as an optional feature and skips the audit write.
229229

230+
If an application provides a custom Blameable behavior subclass, it can instead
231+
change the protected `$auditEnabled` default. Explicit `auditEnabled` options
232+
always override subclass defaults.
233+
230234
Audit detail rows remain enabled when audit is enabled. Disable detail rows with
231235
`auditDetailEnabled => false`.
232236

0 commit comments

Comments
 (0)