mirror of
https://github.com/caddyserver/website.git
synced 2025-04-23 05:26:16 -04:00
29 lines
850 B
Markdown
29 lines
850 B
Markdown
![]() |
---
|
||
|
title: request_header (Caddyfile directive)
|
||
|
---
|
||
|
|
||
|
# request_header
|
||
|
|
||
|
Manipulates HTTP header fields on the request. It can set, add, and delete header values, or perform replacements using regular expressions.
|
||
|
|
||
|
|
||
|
## Syntax
|
||
|
|
||
|
```
|
||
|
request_header [<matcher>] [[+|-]<field> [<value>|<find>] [<replace>]]
|
||
|
```
|
||
|
|
||
|
- **<field>** is the name of the header field. By default, will overwrite any existing field of the same name. Prefix with `+` to add the field instead of replace, or prefix with `-` to remove the field.
|
||
|
- **<value>** is the header field value, if adding or setting a field.
|
||
|
- **<find>** is the substring or regular expression to search for.
|
||
|
- **<replace>** is the replacement value; required if performing a search-and-replace.
|
||
|
|
||
|
|
||
|
## Examples
|
||
|
|
||
|
Remove the Referer header from the request:
|
||
|
|
||
|
```
|
||
|
request_header -Referer
|
||
|
```
|