mirror of
https://github.com/silverstripe/silverstripe-framework
synced 2024-10-22 14:05:37 +02:00
Clarify how Only and Except rules combine
This commit is contained in:
parent
5484283a25
commit
df218d76da
@ -227,8 +227,8 @@ To accommodate this, value sections can be filtered to only be used when either
|
||||
current environment.
|
||||
|
||||
To achieve this you add a key to the related header section, either "Only" when the value section should be included
|
||||
only when the rules contained match, or "Except" when the value section should be included except when the rules
|
||||
contained match.
|
||||
only when all the rules contained match, or "Except" when the value section should be included except when all of the
|
||||
rules contained match.
|
||||
|
||||
You then list any of the following rules as sub-keys, with informational values as either a single value or a list.
|
||||
|
||||
@ -256,6 +256,12 @@ For instance, to add a property to "foo" when a module exists, and "bar" otherwi
|
||||
property: 'bar'
|
||||
---
|
||||
|
||||
Note than when you have more than one rule for a nested fragment, they're joined like
|
||||
|
||||
FRAGMENT_INCLUDED = (ONLY && ONLY) && !(EXCEPT && EXCEPT)
|
||||
|
||||
That is, the fragment will be included if all Only rules match, except if all Except rules match
|
||||
|
||||
### The values
|
||||
|
||||
The values section of YAML configuration files is quite simple - it is simply a nested key / value pair structure
|
||||
|
Loading…
Reference in New Issue
Block a user