From 0449c3c4ac1a60dde24225d648546362c3bc3fa1 Mon Sep 17 00:00:00 2001 From: Eric Wong Date: Sun, 28 Feb 2016 22:28:50 +0000 Subject: examples/: PSGI example updates Users wanting to customize their installation should know to about the usability of STDOUT for logging. (and we still need manpages for -nntpd and -httpd) --- examples/public-inbox.psgi | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/examples/public-inbox.psgi b/examples/public-inbox.psgi index 0d11c19f..f5749122 100644 --- a/examples/public-inbox.psgi +++ b/examples/public-inbox.psgi @@ -3,6 +3,8 @@ # License: AGPLv3 or later (https://www.gnu.org/licenses/agpl-3.0.txt) # Note: this is part of our test suite, update t/plack.t if this changes # Usage: plackup [OPTIONS] /path/to/this/file +# A startup command for development which monitors changes: +# plackup -I lib -o 127.0.0.1 -R lib -r examples/public-inbox.psgi use strict; use warnings; use PublicInbox::WWW; @@ -22,6 +24,7 @@ builder { }; $@ and warn "Plack::Middleware::Deflater missing, bandwidth will be wasted\n"; + # Enable to ensure redirects and Atom feed URLs are generated # properly when running behind a reverse proxy server which # sets X-Forwarded-For and X-Forwarded-Proto request headers. @@ -31,6 +34,13 @@ builder { "Plack::Middleware::ReverseProxy missing,\n", "URL generation for redirects may be wrong if behind a reverse proxy\n"; + # Optional: Log timing information for requests to track performance. + # Logging to STDOUT is recommended since public-inbox-httpd knows + # how to reopen it via SIGUSR1 after log rotation. + # enable 'AccessLog::Timed', + # logger => sub { syswrite(STDOUT, $_[0]) }, + # format => '%t "%r" %>s %b %D'; + enable 'Head'; sub { $www->call(@_) }; } -- cgit v1.2.3-24-ge0c7