caddy-website/src/docs/markdown/caddyfile/directives/handle_path.md

title
handle_path (Caddyfile directive)

handle_path

Same as the handle directive, but implicitly strips the matched path prefix.

Handling a request matching a certain path (while stripping that path from the request URI) is a common enough use case that it has its own directive for convenience.

Syntax

handle_path <path_matcher> {
	<directives...>
}

• <directives...> is a list of HTTP handler directives or directive blocks, one per line, just like would be used outside of a handle_path block.

Note that only a single path matcher is accepted and required; you cannot use other kinds of matchers with handle_path.

Examples

This configuration:

handle_path /prefix/* {
	...
}

is effectively the same as this:

handle /prefix/* {
	uri strip_prefix /prefix
	...
}

but the handle_path form is slightly more succinct.