mirrors/caddy-website
1
0
Fork 0
mirror of https://github.com/caddyserver/website.git synced 2025-04-22 13:06:16 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions

docs: Fixup handle_response for fixes landing in 2.4.1 (#165)

Browse source
This commit is contained in:
Francis Lavoie 2021-05-13 13:11:10 -04:00 • committed by GitHub
parent 9b4599eec9
commit e30f3f8330
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 7 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

8
src/docs/markdown/caddyfile/directives/reverse_proxy.md
View file

@ -263,6 +263,12 @@ The reverse proxy can be configured to intercept responses from the backend. To
- **@name** is the name of a [response matcher](#response-matcher). As long as each response matcher has a unique name, multiple matchers can be defined. A response can be matched on the status code and presence or value of a response header. - **@name** is the name of a [response matcher](#response-matcher). As long as each response matcher has a unique name, multiple matchers can be defined. A response can be matched on the status code and presence or value of a response header.
- **handle_response** defines the route to execute when matched by the given matcher (or, if a matcher is omitted, all responses). The first matching block will be applied. Inside a `handle_response` block, any other [directives](/docs/caddyfile/directives) can be used. - **handle_response** defines the route to execute when matched by the given matcher (or, if a matcher is omitted, all responses). The first matching block will be applied. Inside a `handle_response` block, any other [directives](/docs/caddyfile/directives) can be used.
Three placeholders will be made available to the `handle_response` routes:
- `{http.reverse_proxy.status_code}` The status code from the backend's response.
- `{http.reverse_proxy.status_text}` The status text from the backend's response.
- `{http.reverse_proxy.header.*}` The headers from the backend's response.
#### Response matcher #### Response matcher
**Response matchers** can be used to filter (or classify) responses by specific criteria. **Response matchers** can be used to filter (or classify) responses by specific criteria.
@ -344,7 +350,7 @@ reverse_proxy localhost:8080 {
@accel header X-Accel-Redirect * @accel header X-Accel-Redirect *
handle_response @accel { handle_response @accel {
root * /path/to/private/files root * /path/to/private/files
rewrite {http.response.header.X-Accel-Redirect} rewrite {http.reverse_proxy.header.X-Accel-Redirect}
file_server file_server
} }
} }