mirror of
https://github.com/foxcpp/maddy.git
synced 2025-04-05 22:17:39 +03:00
5d6d1a3a53
* use <h3> and <hr> elements to separate configuration directives * use <code> elements to mark constants, fs paths, module names etc. * fix unneeded "\_" escaping * fix list formatting
63 lines
1.6 KiB
Markdown
63 lines
1.6 KiB
Markdown
# Regexp rewrite table
|
|
|
|
The 'regexp' module implements table lookups by applying a regular expression
|
|
to the key value. If it matches - 'replacement' value is returned with $N
|
|
placeholders being replaced with corresponding capture groups from the match.
|
|
Otherwise, no value is returned.
|
|
|
|
The regular expression syntax is the subset of PCRE. See
|
|
[https://golang.org/pkg/regexp/syntax](https://golang.org/pkg/regexp/syntax)/ for details.
|
|
|
|
```
|
|
table.regexp <regexp> [replacement] {
|
|
full_match yes
|
|
case_insensitive yes
|
|
expand_placeholders yes
|
|
}
|
|
```
|
|
|
|
Note that [replacement] is optional. If it is not included - table.regexp
|
|
will return the original string, therefore acting as a regexp match check.
|
|
This can be useful in combination in `destination_in` for
|
|
advanced matching:
|
|
|
|
```
|
|
destination_in regexp ".*-bounce+.*@example.com" {
|
|
...
|
|
}
|
|
```
|
|
|
|
## Configuration directives
|
|
|
|
### full_match _boolean_
|
|
Default: `yes`
|
|
|
|
Whether to implicitly add start/end anchors to the regular expression.
|
|
That is, if `full_match` is `yes`, then the provided regular expression should
|
|
match the whole string. With `no` - partial match is enough.
|
|
|
|
---
|
|
|
|
### case_insensitive _boolean_
|
|
Default: `yes`
|
|
|
|
Whether to make matching case-insensitive.
|
|
|
|
---
|
|
|
|
### expand_placeholders _boolean_
|
|
Default: `yes`
|
|
|
|
Replace '$name' and '${name}' in the replacement string with contents of
|
|
corresponding capture groups from the match.
|
|
|
|
To insert a literal $ in the output, use $$ in the template.
|
|
|
|
## Identity table (table.identity)
|
|
|
|
The module 'identity' is a table module that just returns the key looked up.
|
|
|
|
```
|
|
table.identity { }
|
|
```
|
|
|