NAME Message::Passing::PSGI - ALPHA QUALITY PSGI adaptor for Message::Passing SYNOPSIS # Run the server - note that the -e has to all be on one line! plackup -E production -s Twiggy -MPlack::App::Message::Passing -e'Plack::App::Message::Passing->new(return_address => "tcp://127.0.0.1:5555", send_address => "tcp://127.0.0.1:5556")->to_app' # Run your app with the handler plackup -E production -s Message::Passing testapp.psgi --host 127.0.0.1 --port 5556 # Browse to: http://localhost:5000/ DESCRIPTION ALPHA QUALITY EXPERIMENT - YOU HAVE BEEN WARNED! This module implements a mongrel2 like strategy for web handlers, using Message::Passing::ZeroMQ. WHY Because I could! It's a useful experiment to prove that Message::Passing can be used for things entirely unlike my initial goals. NO, REALLY? Theoretically, this is quite an interesting model - as you've totally split the front end connection acceptance and the back end request handling, you can do things which are harder in other server environments trivially. Examples of things that 'just work' include: Adding more handler processes Totally dynamic, run as many as you want Adding handler processes on other servers As long as your send/return sockets are bound to a host that's network accessible, you can spin up handlers wherever you want. Upgrade the application in production You can spin up a new version, verify it appears to be working correctly etc before shutting down the old version Profile the application in production Just run a handler with NYTProf.. NOTE: The properties above _do not_ exist in the current code - you will drop requests in-flight if you shut handlers down!! (Patches to fix this should not be that hard, and would be welcome if anyone is interested) If you're actually interested in using this in production, I'd recommend you look at the real mongrel2, and Plack::Handler::Mongrel2. BUGS Many, and varied. Please do not try to run this in production ;_) Issues include: Large responses will use SEVERAL times the response length in RAM Requests never timeout App Handler crashes / restarts will lost in-flight requests. Quite probably leaks RAM. This has not been tested, which means I quite probably got it wrong somewhere ;) SEE ALSO Plack::App::Message::Passing. Plack::Handler::Message::Passing. mongrel2 Message::Passing Message::Passing::ZeroMQ. AUTHOR Tomas Doran (t0m) "" COPYRIGHT Copyright the above author. LICENSE GNU Affero General Public License, Version 3 If you feel this is too restrictive to be able to use this software, please talk to us as we'd be willing to consider re-licensing under less restrictive terms.