serv/caddy
1
0
Fork 0
mirror of https://github.com/caddyserver/caddy.git synced 2025-03-26 23:11:05 +03:00
Code Issues Projects Releases Packages Wiki Activity Actions 3

fileserver: docs: clarify the ability to produce JSON array with browse (#5751)

Browse source
This commit is contained in:
Mohammed Al Sahaf 2023-08-18 21:04:08 +02:00 committed by GitHub
parent 568fd2b286
commit 0a6d3333b2
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 17 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

18
modules/caddyhttp/fileserver/staticfiles.go
View file

@ -60,7 +60,23 @@ func init() {
// requested directory does not have an index file, Caddy writes a // requested directory does not have an index file, Caddy writes a
// 404 response. Alternatively, file browsing can be enabled with // 404 response. Alternatively, file browsing can be enabled with
// the "browse" parameter which shows a list of files when directories // the "browse" parameter which shows a list of files when directories
// are requested if no index file is present. // are requested if no index file is present. If "browse" is enabled,
// Caddy may serve a JSON array of the dirctory listing when the `Accept`
// header mentions `application/json` with the following structure:
//
// [{
// "name": "",
// "size": 0,
// "url": "",
// "mod_time": "",
// "mode": 0,
// "is_dir": false,
// "is_symlink": false
// }]
//
// with the `url` being relative to the request path and `mod_time` in the RFC 3339 format
// with sub-second precision. For any other value for the `Accept` header, the
// respective browse template is executed with `Content-Type: text/html`.
// //
// By default, this handler will canonicalize URIs so that requests to // By default, this handler will canonicalize URIs so that requests to
// directories end with a slash, but requests to regular files do not. // directories end with a slash, but requests to regular files do not.