oqapi/webgui
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

some documentation additions/fixes

Browse source
This commit is contained in:
Graham Knop 2010-04-23 19:22:37 -05:00 • committed by Graham Knop
parent cb3f83a93e
commit 8cd0f80bd4
2 changed files with 12 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

13
README
View file

@ -9,22 +9,25 @@ To try this out:
Currently, the best performance is achieved via: Currently, the best performance is achieved via:
plackup -E none -s Starman --workers 10 --disable-keepalive plackup -E none -s Starman --workers 10 --disable-keepalive
You can benchmark your server via: You can benchmark your server via:
ab -t 3 -c 10 -k http://dev.localhost.localdomain:5000/ | grep Req ab -t 3 -c 10 -k http://dev.localhost.localdomain:5000/ | grep Req
I'm currently getting 370 requests/second, whereas I'm getting 430/second on the non-PSGI WebGUI8 branch. I'm currently getting 370 requests/second, whereas I'm getting 430/second on the non-PSGI WebGUI8 branch.
= ARCHITECTURE = = ARCHITECTURE =
* The .psgi file gets to set WEBGUI_ROOT and WEBGUI_CONFIG. * The root level app.psgi file loads all the config files found and
loads the site specific psgi file for each, linking them to the
proper host names.
* The site psgi file uses the WEBGUI_CONFIG environment variable to find the config.
* It instantiates the $wg WebGUI object (one per app). * It instantiates the $wg WebGUI object (one per app).
* $wg creates and stores the WebGUI::Config (one per app) * $wg creates and stores the WebGUI::Config (one per app)
* $wg creates the $app PSGI app code ref (one per app) * $wg creates the $app PSGI app code ref (one per app)
* WebGUI::Middleware::Session is wrapped around $app at the outer-most layer so that it can open and * WebGUI::Middleware::Session is wrapped around $app at the outer-most layer so that it can open and
close the $session WebGUI::Session. Any other wG middleware that needs $session should go in between close the $session WebGUI::Session. Any other wG middleware that needs $session should go in between
it and $app ($session created one per request) it and $app ($session created one per request)
* $session creates the $request WebGUI::Session::Request and $response WebGUI::Session::Response * $session creates the $request WebGUI::Session::Request and $response WebGUI::Session::Response
objects (one per request) objects (one per request)

5
app.psgi
View file

@ -9,7 +9,8 @@ builder {
my $config = WebGUI::Config->new($config_file); my $config = WebGUI::Config->new($config_file);
my $psgi = $config->get('psgiFile') || WebGUI::Paths->defaultPSGI; my $psgi = $config->get('psgiFile') || WebGUI::Paths->defaultPSGI;
my $app = do { my $app = do {
$ENV{WEBGUI_CONFIG} = $config_file; # default psgi file uses environment variable to find config file
local $ENV{WEBGUI_CONFIG} = $config_file;
Plack::Util::load_psgi($psgi); Plack::Util::load_psgi($psgi);
}; };
$first_app ||= $app; $first_app ||= $app;
@ -17,6 +18,8 @@ builder {
mount "http://$sitename/" => $app; mount "http://$sitename/" => $app;
} }
} }
# use the first config found as a fallback
mount '/' => $first_app; mount '/' => $first_app;
}; };