I somehow forgot to add this to the docs when I implemented it a while back. Someone asked a question on the forums where this was the solution, and I noticed it wasn't documented.
We did recently add a similar example to the `abort` directive docs, but I feel this is a good fit in this page as well since it's a commonly repeated pattern we respond with when answering forum questions.
Docs for the new directive in https://github.com/caddyserver/caddy/pull/4034.
Also adding a bit in `handle_errors` mentioning that `reverse_proxy` doesn't trigger errors when a response has an "error" HTTP status; not sure how to word this clearly, cause `reverse_proxy` still can trigger errors if there's no upstream or whatever. We should probably add examples for that later, and augment this paragraph to mention `handle_response` once that's merged (https://github.com/caddyserver/caddy/pull/4021)
https://github.com/caddyserver/caddy/pull/3991
The `outputs` bit was getting a bit long so I split it up into multiple paragraphs.
The capture group explanation is copied from the `path_regexp` matcher docs.
Added bullets in front of the example cases, because the newlines get collapsed in markdown otherwise, unless we either add bullets or double newlines. I think bullets work better here.
* docs: Some cleanup, some v2.4.0 additions
- Add `abort` directive docs
- Add a note in `handle` to cross-link to `handle_path`
- Add another example in `handle_errors` that shows how an `expression` matcher can be used to pair with it
- Add a cat emoji to handle_errors because 😸
- Add `file_server` to one of the `php_fastcgi` examples, it's rare that you'll ever use it without `file_server` so might as well include it there
- Add a TOC to `reverse_proxy` cause it's such a long page. Maybe we'll add one to other pages as well, but TBD
- Clarify the upstream address stuff a bit after some discussion in https://caddy.community/t/reverse-proxy-with-multiple-different-upstreams-with-paths/11512/12 and mention `rewrite` as the alternative
- Use the `{re.*.*}` shortcut in the Caddyfile matcher docs, links to the placeholder mapping to let people trace where that comes from
* docs: Revise the `handle` cross-linking, add another example
* docs: Bump minimum Go version to 1.15
* docs: A bunch more additions since v2.3.0
I went through the whole list of commits here: https://github.com/caddyserver/caddy/compare/v2.3.0...ec3ac84
* docs: Review feedback
* docs: Link to https://golang.org/doc/install, better instructions
We now have only 1 download page, yay. Install docs are organized better. Less confusing.
Automatic HTTPS docs improved, and menu added.
Other minor updates to bring up to speed for v2.3.
* docs: Add caddyfile server options, reorganize the page a bit
* Apply suggestions from code review
Co-authored-by: Matt Holt <mholt@users.noreply.github.com>
Co-authored-by: Matt Holt <mholt@users.noreply.github.com>
* docs: Clarify behaviour of multiple matchers of the same type
* Apply suggestions from code review
Co-authored-by: Matt Holt <mholt@users.noreply.github.com>
* docs: Change matcher boolean wording
* Apply suggestions from code review
Co-authored-by: Matt Holt <mholt@users.noreply.github.com>
Co-authored-by: Matt Holt <mholt@users.noreply.github.com>
* Add documentation about request_body directive in Caddyfile
* Add note about matchers support
Co-authored-by: Francis Lavoie <lavofr@gmail.com>
* Improve description of max_size parameter
Co-authored-by: Matt Holt <mholt@users.noreply.github.com>
* Improve text
Co-authored-by: Matt Holt <mholt@users.noreply.github.com>
* Improve description of request_body directive
Co-authored-by: Matt Holt <mholt@users.noreply.github.com>
Co-authored-by: Francis Lavoie <lavofr@gmail.com>
Co-authored-by: Matt Holt <mholt@users.noreply.github.com>
