passenger 2.2.2 → 2.2.3
Sign up to get free protection for your applications and to get access to all the features.
Potentially problematic release.
This version of passenger might be problematic. Click here for more details.
- data/DEVELOPERS.TXT +13 -3
- data/Rakefile +42 -33
- data/bin/passenger-install-apache2-module +1 -2
- data/bin/passenger-install-nginx-module +7 -19
- data/bin/passenger-status +64 -15
- data/bin/passenger-stress-test +2 -2
- data/doc/ApplicationPool algorithm.txt +26 -22
- data/doc/Users guide Apache.html +374 -149
- data/doc/Users guide Apache.txt +318 -51
- data/doc/Users guide Nginx.html +13 -13
- data/doc/Users guide Nginx.txt +7 -2
- data/doc/cxxapi/Bucket_8h-source.html +62 -25
- data/doc/cxxapi/Configuration_8h-source.html +343 -326
- data/doc/cxxapi/DirectoryMapper_8h-source.html +12 -12
- data/doc/cxxapi/Hooks_8h-source.html +1 -1
- data/doc/cxxapi/annotated.html +1 -1
- data/doc/cxxapi/classHooks-members.html +1 -1
- data/doc/cxxapi/classHooks.html +1 -1
- data/doc/cxxapi/classPassenger_1_1DirectoryMapper-members.html +2 -2
- data/doc/cxxapi/classPassenger_1_1DirectoryMapper.html +9 -9
- data/doc/cxxapi/classes.html +1 -1
- data/doc/cxxapi/definitions_8h-source.html +1 -1
- data/doc/cxxapi/files.html +1 -1
- data/doc/cxxapi/functions.html +2 -2
- data/doc/cxxapi/functions_func.html +2 -2
- data/doc/cxxapi/graph_legend.html +1 -1
- data/doc/cxxapi/group__Configuration.html +1 -1
- data/doc/cxxapi/group__Core.html +1 -1
- data/doc/cxxapi/group__Hooks.html +1 -1
- data/doc/cxxapi/group__Support.html +1 -1
- data/doc/cxxapi/main.html +1 -1
- data/doc/cxxapi/modules.html +1 -1
- data/doc/rdoc/classes/ConditionVariable.html +194 -0
- data/doc/rdoc/classes/Exception.html +120 -0
- data/doc/rdoc/classes/GC.html +113 -0
- data/doc/rdoc/classes/IO.html +169 -0
- data/doc/rdoc/classes/PhusionPassenger.html +238 -0
- data/doc/rdoc/classes/PhusionPassenger/AbstractInstaller.html +153 -0
- data/doc/rdoc/classes/PhusionPassenger/AbstractRequestHandler.html +517 -0
- data/doc/rdoc/classes/PhusionPassenger/AbstractServer.html +719 -0
- data/doc/rdoc/classes/PhusionPassenger/AbstractServer/ServerAlreadyStarted.html +97 -0
- data/doc/rdoc/classes/PhusionPassenger/AbstractServer/ServerError.html +96 -0
- data/doc/rdoc/classes/PhusionPassenger/AbstractServer/ServerNotStarted.html +97 -0
- data/doc/rdoc/classes/PhusionPassenger/AbstractServer/UnknownMessage.html +96 -0
- data/doc/rdoc/classes/PhusionPassenger/AbstractServerCollection.html +598 -0
- data/doc/rdoc/classes/PhusionPassenger/AdminTools.html +140 -0
- data/doc/rdoc/classes/PhusionPassenger/AdminTools/ControlProcess.html +317 -0
- data/doc/rdoc/classes/PhusionPassenger/AdminTools/ControlProcess/Instance.html +138 -0
- data/doc/rdoc/classes/PhusionPassenger/AppInitError.html +154 -0
- data/doc/rdoc/classes/PhusionPassenger/Application.html +283 -0
- data/doc/rdoc/classes/PhusionPassenger/ConsoleTextTemplate.html +172 -0
- data/doc/rdoc/classes/PhusionPassenger/FrameworkInitError.html +145 -0
- data/doc/rdoc/classes/PhusionPassenger/HTMLTemplate.html +175 -0
- data/doc/rdoc/classes/PhusionPassenger/InitializationError.html +141 -0
- data/doc/rdoc/classes/PhusionPassenger/InvalidPath.html +92 -0
- data/doc/rdoc/classes/PhusionPassenger/MessageChannel.html +489 -0
- data/doc/rdoc/classes/PhusionPassenger/NativeSupport.html +350 -0
- data/doc/rdoc/classes/PhusionPassenger/Rack.html +91 -0
- data/doc/rdoc/classes/PhusionPassenger/Rack/ApplicationSpawner.html +188 -0
- data/doc/rdoc/classes/PhusionPassenger/Rack/RequestHandler.html +194 -0
- data/doc/rdoc/classes/PhusionPassenger/Railz.html +95 -0
- data/doc/rdoc/classes/PhusionPassenger/Railz/ApplicationSpawner.html +442 -0
- data/doc/rdoc/classes/PhusionPassenger/Railz/ApplicationSpawner/Error.html +98 -0
- data/doc/rdoc/classes/PhusionPassenger/Railz/CGIFixed.html +200 -0
- data/doc/rdoc/classes/PhusionPassenger/Railz/FrameworkSpawner.html +436 -0
- data/doc/rdoc/classes/PhusionPassenger/Railz/FrameworkSpawner/Error.html +98 -0
- data/doc/rdoc/classes/PhusionPassenger/Railz/RequestHandler.html +155 -0
- data/doc/rdoc/classes/PhusionPassenger/SpawnManager.html +402 -0
- data/doc/rdoc/classes/PhusionPassenger/UnknownError.html +125 -0
- data/doc/rdoc/classes/PhusionPassenger/Utils.html +805 -0
- data/doc/rdoc/classes/PhusionPassenger/VersionNotFound.html +140 -0
- data/doc/rdoc/classes/PhusionPassenger/WSGI.html +89 -0
- data/doc/rdoc/classes/PhusionPassenger/WSGI/ApplicationSpawner.html +188 -0
- data/doc/rdoc/classes/PlatformInfo.html +831 -0
- data/doc/rdoc/classes/RakeExtensions.html +197 -0
- data/doc/rdoc/classes/Signal.html +131 -0
- data/doc/rdoc/created.rid +1 -0
- data/doc/rdoc/files/DEVELOPERS_TXT.html +255 -0
- data/doc/rdoc/files/README.html +157 -0
- data/doc/rdoc/files/ext/phusion_passenger/native_support_c.html +92 -0
- data/doc/rdoc/files/lib/phusion_passenger/abstract_installer_rb.html +129 -0
- data/doc/rdoc/files/lib/phusion_passenger/abstract_request_handler_rb.html +131 -0
- data/doc/rdoc/files/lib/phusion_passenger/abstract_server_collection_rb.html +126 -0
- data/doc/rdoc/files/lib/phusion_passenger/abstract_server_rb.html +130 -0
- data/doc/rdoc/files/lib/phusion_passenger/admin_tools/control_process_rb.html +130 -0
- data/doc/rdoc/files/lib/phusion_passenger/admin_tools_rb.html +122 -0
- data/doc/rdoc/files/lib/phusion_passenger/application_rb.html +127 -0
- data/doc/rdoc/files/lib/phusion_passenger/console_text_template_rb.html +126 -0
- data/doc/rdoc/files/lib/phusion_passenger/constants_rb.html +122 -0
- data/doc/rdoc/files/lib/phusion_passenger/dependencies_rb.html +134 -0
- data/doc/rdoc/files/lib/phusion_passenger/events_rb.html +122 -0
- data/doc/rdoc/files/lib/phusion_passenger/exceptions_rb.html +122 -0
- data/doc/rdoc/files/lib/phusion_passenger/html_template_rb.html +126 -0
- data/doc/rdoc/files/lib/phusion_passenger/message_channel_rb.html +122 -0
- data/doc/rdoc/files/lib/phusion_passenger/packaging_rb.html +122 -0
- data/doc/rdoc/files/lib/phusion_passenger/platform_info_rb.html +127 -0
- data/doc/rdoc/files/lib/phusion_passenger/rack/application_spawner_rb.html +133 -0
- data/doc/rdoc/files/lib/phusion_passenger/rack/request_handler_rb.html +127 -0
- data/doc/rdoc/files/lib/phusion_passenger/railz/application_spawner_rb.html +143 -0
- data/doc/rdoc/files/lib/phusion_passenger/railz/cgi_fixed_rb.html +126 -0
- data/doc/rdoc/files/lib/phusion_passenger/railz/framework_spawner_rb.html +145 -0
- data/doc/rdoc/files/lib/phusion_passenger/railz/request_handler_rb.html +127 -0
- data/doc/rdoc/files/lib/phusion_passenger/simple_benchmarking_rb.html +122 -0
- data/doc/rdoc/files/lib/phusion_passenger/spawn_manager_rb.html +161 -0
- data/doc/rdoc/files/lib/phusion_passenger/utils_rb.html +175 -0
- data/doc/rdoc/files/lib/phusion_passenger/wsgi/application_spawner_rb.html +129 -0
- data/doc/rdoc/files/misc/rake/extensions_rb.html +130 -0
- data/doc/rdoc/fr_class_index.html +90 -0
- data/doc/rdoc/fr_file_index.html +76 -0
- data/doc/rdoc/fr_method_index.html +200 -0
- data/doc/rdoc/index.html +26 -0
- data/doc/rdoc/rdoc-style.css +187 -0
- data/doc/users_guide_snippets/rackup_specifications.txt +2 -8
- data/ext/apache2/Bucket.cpp +71 -38
- data/ext/apache2/Bucket.h +53 -16
- data/ext/apache2/Configuration.cpp +15 -0
- data/ext/apache2/Configuration.h +19 -2
- data/ext/apache2/DirectoryMapper.h +10 -10
- data/ext/apache2/Hooks.cpp +334 -74
- data/ext/boost/mpl/apply.hpp +5 -1
- data/ext/boost/mpl/apply_wrap.hpp +5 -2
- data/ext/boost/mpl/aux_/full_lambda.hpp +5 -1
- data/ext/boost/mpl/bind.hpp +5 -1
- data/ext/common/Application.h +11 -31
- data/ext/common/ApplicationPool.h +2 -1
- data/ext/common/ApplicationPoolServer.h +61 -20
- data/ext/common/ApplicationPoolServerExecutable.cpp +132 -4
- data/ext/common/ApplicationPoolStatusReporter.h +189 -65
- data/ext/common/Base64.cpp +143 -0
- data/ext/common/Base64.h +57 -0
- data/ext/common/CachedFileStat.cpp +25 -82
- data/ext/common/CachedFileStat.h +11 -125
- data/ext/common/CachedFileStat.hpp +243 -0
- data/ext/common/Exceptions.h +13 -0
- data/ext/common/FileChangeChecker.h +209 -0
- data/ext/common/Logging.h +3 -2
- data/ext/common/MessageChannel.h +10 -10
- data/ext/common/PoolOptions.h +72 -5
- data/ext/common/SpawnManager.h +11 -8
- data/ext/common/StandardApplicationPool.h +38 -39
- data/ext/common/StaticString.h +1 -0
- data/ext/common/StringListCreator.h +83 -0
- data/ext/common/SystemTime.h +3 -2
- data/ext/common/Timer.h +88 -0
- data/ext/common/Utils.cpp +161 -42
- data/ext/common/Utils.h +62 -31
- data/ext/common/Version.h +1 -1
- data/ext/nginx/Configuration.c +0 -4
- data/ext/nginx/ContentHandler.c +8 -6
- data/ext/nginx/HelperServer.cpp +45 -55
- data/ext/nginx/HttpStatusExtractor.h +4 -0
- data/ext/nginx/StaticContentHandler.c +25 -5
- data/ext/nginx/config +3 -0
- data/ext/nginx/ngx_http_passenger_module.c +72 -17
- data/ext/nginx/ngx_http_passenger_module.h +2 -2
- data/lib/phusion_passenger/abstract_request_handler.rb +15 -7
- data/lib/phusion_passenger/abstract_server.rb +16 -2
- data/lib/phusion_passenger/admin_tools/control_process.rb +36 -25
- data/lib/phusion_passenger/constants.rb +1 -1
- data/lib/phusion_passenger/dependencies.rb +10 -0
- data/lib/phusion_passenger/platform_info.rb +1 -1
- data/lib/phusion_passenger/rack/application_spawner.rb +21 -2
- data/lib/phusion_passenger/rack/request_handler.rb +10 -0
- data/lib/phusion_passenger/railz/application_spawner.rb +38 -2
- data/lib/phusion_passenger/railz/framework_spawner.rb +26 -28
- data/lib/phusion_passenger/railz/request_handler.rb +5 -1
- data/lib/phusion_passenger/spawn_manager.rb +6 -2
- data/lib/phusion_passenger/utils.rb +79 -27
- data/misc/rake/cplusplus.rb +5 -5
- data/test/ApplicationPoolServerTest.cpp +42 -0
- data/test/ApplicationPoolTest.cpp +255 -267
- data/test/Base64Test.cpp +48 -0
- data/test/CachedFileStatTest.cpp +243 -103
- data/test/FileChangeCheckerTest.cpp +331 -0
- data/test/PoolOptionsTest.cpp +80 -0
- data/test/UtilsTest.cpp +5 -17
- data/test/integration_tests/apache2_tests.rb +15 -4
- data/test/integration_tests/mycook_spec.rb +3 -4
- data/test/oxt/syscall_interruption_test.cpp +2 -14
- data/test/ruby/abstract_server_collection_spec.rb +1 -1
- data/test/ruby/abstract_server_spec.rb +35 -1
- data/test/ruby/rack/application_spawner_spec.rb +23 -6
- data/test/ruby/rails/application_spawner_spec.rb +6 -6
- data/test/ruby/rails/framework_spawner_spec.rb +6 -5
- data/test/ruby/rails/minimal_spawner_spec.rb +19 -0
- data/test/ruby/rails/spawner_error_handling_spec.rb +62 -7
- data/test/ruby/spawn_manager_spec.rb +10 -7
- data/test/ruby/spawn_server_spec.rb +1 -1
- data/test/ruby/utils_spec.rb +193 -20
- data/test/ruby/wsgi/application_spawner_spec.rb +3 -1
- data/test/stub/apache2/httpd.conf.erb +3 -0
- data/test/stub/rack/config.ru +1 -1
- data/test/stub/rails_apps/mycook/app/controllers/welcome_controller.rb +8 -0
- data/test/support/Support.cpp +84 -0
- data/test/support/Support.h +66 -8
- data/test/support/config.rb +14 -2
- data/test/support/test_helper.rb +5 -0
- data/vendor/rack-1.0.0-git/lib/rack/auth/openid.rb +123 -116
- data/vendor/rack-1.0.0-git/lib/rack/cascade.rb +17 -12
- data/vendor/rack-1.0.0-git/lib/rack/commonlogger.rb +34 -43
- data/vendor/rack-1.0.0-git/lib/rack/handler/cgi.rb +1 -1
- data/vendor/rack-1.0.0-git/lib/rack/handler/fastcgi.rb +1 -1
- data/vendor/rack-1.0.0-git/lib/rack/handler/lsws.rb +1 -1
- data/vendor/rack-1.0.0-git/lib/rack/handler/mongrel.rb +1 -1
- data/vendor/rack-1.0.0-git/lib/rack/handler/scgi.rb +1 -1
- data/vendor/rack-1.0.0-git/lib/rack/handler/webrick.rb +1 -1
- data/vendor/rack-1.0.0-git/lib/rack/mock.rb +4 -17
- data/vendor/rack-1.0.0-git/lib/rack/request.rb +3 -9
- data/vendor/rack-1.0.0-git/lib/rack/rewindable_input.rb +2 -0
- data/vendor/rack-1.0.0-git/lib/rack/utils.rb +38 -12
- metadata +231 -186
- data/ext/common/FileChecker.h +0 -112
- data/test/FileCheckerTest.cpp +0 -79
- data/test/stub/minimal-railsapp/README +0 -3
- data/test/stub/minimal-railsapp/config/application.rb +0 -0
- data/test/stub/minimal-railsapp/config/environment.rb +0 -3
- data/test/stub/minimal-railsapp/vendor/rails/actionmailer/lib/action_mailer.rb +0 -0
- data/test/stub/minimal-railsapp/vendor/rails/actionpack/lib/action_controller.rb +0 -10
- data/test/stub/minimal-railsapp/vendor/rails/actionpack/lib/action_pack.rb +0 -0
- data/test/stub/minimal-railsapp/vendor/rails/actionpack/lib/action_view.rb +0 -0
- data/test/stub/minimal-railsapp/vendor/rails/activerecord/lib/active_record.rb +0 -7
- data/test/stub/minimal-railsapp/vendor/rails/activeresource/lib/active_resource.rb +0 -0
- data/test/stub/minimal-railsapp/vendor/rails/activesupport/lib/active_support.rb +0 -17
- data/test/stub/minimal-railsapp/vendor/rails/activesupport/lib/active_support/whiny_nil.rb +0 -0
- data/test/stub/minimal-railsapp/vendor/rails/railties/lib/dispatcher.rb +0 -0
- data/test/stub/minimal-railsapp/vendor/rails/railties/lib/initializer.rb +0 -8
- data/test/stub/minimal-railsapp/vendor/rails/railties/lib/ruby_version_check.rb +0 -1
- data/test/stub/railsapp/app/controllers/application.rb +0 -12
- data/test/stub/railsapp/app/controllers/bar_controller.rb +0 -5
- data/test/stub/railsapp/app/controllers/bar_controller_1.txt +0 -5
- data/test/stub/railsapp/app/controllers/bar_controller_2.txt +0 -5
- data/test/stub/railsapp/app/controllers/foo_controller.rb +0 -9
- data/test/stub/railsapp/app/helpers/application_helper.rb +0 -3
- data/test/stub/railsapp/config/boot.rb +0 -108
- data/test/stub/railsapp/config/database.yml +0 -19
- data/test/stub/railsapp/config/environment.rb +0 -59
- data/test/stub/railsapp/config/environments/development.rb +0 -18
- data/test/stub/railsapp/config/environments/production.rb +0 -19
- data/test/stub/railsapp/config/initializers/inflections.rb +0 -10
- data/test/stub/railsapp/config/initializers/mime_types.rb +0 -5
- data/test/stub/railsapp/config/routes.rb +0 -35
- data/test/stub/railsapp/public/useless.txt +0 -1
- data/test/stub/railsapp2/app/controllers/application.rb +0 -12
- data/test/stub/railsapp2/app/controllers/foo_controller.rb +0 -5
- data/test/stub/railsapp2/app/helpers/application_helper.rb +0 -3
- data/test/stub/railsapp2/config/boot.rb +0 -108
- data/test/stub/railsapp2/config/database.yml +0 -19
- data/test/stub/railsapp2/config/environment.rb +0 -59
- data/test/stub/railsapp2/config/environments/development.rb +0 -18
- data/test/stub/railsapp2/config/environments/production.rb +0 -19
- data/test/stub/railsapp2/config/initializers/inflections.rb +0 -10
- data/test/stub/railsapp2/config/initializers/mime_types.rb +0 -5
- data/test/stub/railsapp2/config/routes.rb +0 -35
- data/test/stub/railsapp2/public/useless.txt +0 -1
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
<?xml version="1.0" encoding="iso-8859-1"?>
|
|
2
|
+
<!DOCTYPE html
|
|
3
|
+
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
|
4
|
+
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
5
|
+
<html>
|
|
6
|
+
<head>
|
|
7
|
+
<title>Class: PhusionPassenger::Railz::FrameworkSpawner::Error</title>
|
|
8
|
+
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
|
|
9
|
+
<link rel="stylesheet" href="../../../.././rdoc-style.css" type="text/css" media="screen" />
|
|
10
|
+
|
|
11
|
+
<script language="JavaScript" type="text/javascript">
|
|
12
|
+
// <![CDATA[
|
|
13
|
+
|
|
14
|
+
function toggleSource( id )
|
|
15
|
+
{
|
|
16
|
+
var elem
|
|
17
|
+
var link
|
|
18
|
+
|
|
19
|
+
if( document.getElementById )
|
|
20
|
+
{
|
|
21
|
+
elem = document.getElementById( id )
|
|
22
|
+
link = document.getElementById( "l_" + id )
|
|
23
|
+
}
|
|
24
|
+
else if ( document.all )
|
|
25
|
+
{
|
|
26
|
+
elem = eval( "document.all." + id )
|
|
27
|
+
link = eval( "document.all.l_" + id )
|
|
28
|
+
}
|
|
29
|
+
else
|
|
30
|
+
return false;
|
|
31
|
+
|
|
32
|
+
if( elem.style.display == "block" )
|
|
33
|
+
{
|
|
34
|
+
elem.style.display = "none"
|
|
35
|
+
link.innerHTML = "show source"
|
|
36
|
+
}
|
|
37
|
+
else
|
|
38
|
+
{
|
|
39
|
+
elem.style.display = "block"
|
|
40
|
+
link.innerHTML = "hide source"
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
function openCode( url )
|
|
45
|
+
{
|
|
46
|
+
window.open( url, "SOURCE_CODE", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=480,width=750" ).focus();
|
|
47
|
+
}
|
|
48
|
+
// ]]>
|
|
49
|
+
</script>
|
|
50
|
+
</head>
|
|
51
|
+
|
|
52
|
+
<body>
|
|
53
|
+
<table width="100%" border='0' cellpadding='0' cellspacing='0' class='banner'><tr>
|
|
54
|
+
<td class="file-title"><span class="file-title-prefix">Class</span><br />PhusionPassenger::Railz::FrameworkSpawner::Error</td>
|
|
55
|
+
<td align="right">
|
|
56
|
+
<table cellspacing="0" cellpadding="2">
|
|
57
|
+
<tr valign="top">
|
|
58
|
+
<td>In:</td>
|
|
59
|
+
<td>
|
|
60
|
+
<a href="../../../../files/lib/phusion_passenger/railz/framework_spawner_rb.html">lib/phusion_passenger/railz/framework_spawner.rb</a>
|
|
61
|
+
</td>
|
|
62
|
+
</tr>
|
|
63
|
+
<tr>
|
|
64
|
+
<td>Parent:</td>
|
|
65
|
+
<td>
|
|
66
|
+
AbstractServer::ServerError
|
|
67
|
+
</td>
|
|
68
|
+
</tr>
|
|
69
|
+
</table>
|
|
70
|
+
</td>
|
|
71
|
+
</tr>
|
|
72
|
+
</table>
|
|
73
|
+
<!-- banner header -->
|
|
74
|
+
|
|
75
|
+
<div id="bodyContent">
|
|
76
|
+
<div id="content">
|
|
77
|
+
|
|
78
|
+
<div class="description"><p>
|
|
79
|
+
This exception means that the <a
|
|
80
|
+
href="../FrameworkSpawner.html">FrameworkSpawner</a> server process exited
|
|
81
|
+
unexpectedly.
|
|
82
|
+
</p>
|
|
83
|
+
</div>
|
|
84
|
+
|
|
85
|
+
|
|
86
|
+
|
|
87
|
+
|
|
88
|
+
|
|
89
|
+
|
|
90
|
+
|
|
91
|
+
|
|
92
|
+
|
|
93
|
+
</div>
|
|
94
|
+
|
|
95
|
+
</div>
|
|
96
|
+
|
|
97
|
+
</body>
|
|
98
|
+
</html>
|
|
@@ -0,0 +1,155 @@
|
|
|
1
|
+
<?xml version="1.0" encoding="iso-8859-1"?>
|
|
2
|
+
<!DOCTYPE html
|
|
3
|
+
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
|
4
|
+
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
5
|
+
<html>
|
|
6
|
+
<head>
|
|
7
|
+
<title>Class: PhusionPassenger::Railz::RequestHandler</title>
|
|
8
|
+
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
|
|
9
|
+
<link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
|
|
10
|
+
|
|
11
|
+
<script language="JavaScript" type="text/javascript">
|
|
12
|
+
// <![CDATA[
|
|
13
|
+
|
|
14
|
+
function toggleSource( id )
|
|
15
|
+
{
|
|
16
|
+
var elem
|
|
17
|
+
var link
|
|
18
|
+
|
|
19
|
+
if( document.getElementById )
|
|
20
|
+
{
|
|
21
|
+
elem = document.getElementById( id )
|
|
22
|
+
link = document.getElementById( "l_" + id )
|
|
23
|
+
}
|
|
24
|
+
else if ( document.all )
|
|
25
|
+
{
|
|
26
|
+
elem = eval( "document.all." + id )
|
|
27
|
+
link = eval( "document.all.l_" + id )
|
|
28
|
+
}
|
|
29
|
+
else
|
|
30
|
+
return false;
|
|
31
|
+
|
|
32
|
+
if( elem.style.display == "block" )
|
|
33
|
+
{
|
|
34
|
+
elem.style.display = "none"
|
|
35
|
+
link.innerHTML = "show source"
|
|
36
|
+
}
|
|
37
|
+
else
|
|
38
|
+
{
|
|
39
|
+
elem.style.display = "block"
|
|
40
|
+
link.innerHTML = "hide source"
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
function openCode( url )
|
|
45
|
+
{
|
|
46
|
+
window.open( url, "SOURCE_CODE", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=480,width=750" ).focus();
|
|
47
|
+
}
|
|
48
|
+
// ]]>
|
|
49
|
+
</script>
|
|
50
|
+
</head>
|
|
51
|
+
|
|
52
|
+
<body>
|
|
53
|
+
<table width="100%" border='0' cellpadding='0' cellspacing='0' class='banner'><tr>
|
|
54
|
+
<td class="file-title"><span class="file-title-prefix">Class</span><br />PhusionPassenger::Railz::RequestHandler</td>
|
|
55
|
+
<td align="right">
|
|
56
|
+
<table cellspacing="0" cellpadding="2">
|
|
57
|
+
<tr valign="top">
|
|
58
|
+
<td>In:</td>
|
|
59
|
+
<td>
|
|
60
|
+
<a href="../../../files/lib/phusion_passenger/railz/request_handler_rb.html">lib/phusion_passenger/railz/request_handler.rb</a>
|
|
61
|
+
</td>
|
|
62
|
+
</tr>
|
|
63
|
+
<tr>
|
|
64
|
+
<td>Parent:</td>
|
|
65
|
+
<td>
|
|
66
|
+
AbstractRequestHandler
|
|
67
|
+
</td>
|
|
68
|
+
</tr>
|
|
69
|
+
</table>
|
|
70
|
+
</td>
|
|
71
|
+
</tr>
|
|
72
|
+
</table>
|
|
73
|
+
<!-- banner header -->
|
|
74
|
+
|
|
75
|
+
<div id="bodyContent">
|
|
76
|
+
<div id="content">
|
|
77
|
+
|
|
78
|
+
<div class="description"><p>
|
|
79
|
+
A request handler for Ruby on Rails applications.
|
|
80
|
+
</p>
|
|
81
|
+
</div>
|
|
82
|
+
|
|
83
|
+
|
|
84
|
+
|
|
85
|
+
<div class="sectiontitle">Methods</div>
|
|
86
|
+
<ul>
|
|
87
|
+
<li><a href="#M000052">new</a></li>
|
|
88
|
+
<li><a href="#M000053">process_request</a></li>
|
|
89
|
+
</ul>
|
|
90
|
+
|
|
91
|
+
|
|
92
|
+
|
|
93
|
+
|
|
94
|
+
<div class="sectiontitle">Constants</div>
|
|
95
|
+
<table border='0' cellpadding='5'>
|
|
96
|
+
<tr valign='top'>
|
|
97
|
+
<td class="attr-name">NINJA_PATCHING_LOCK</td>
|
|
98
|
+
<td>=</td>
|
|
99
|
+
<td class="attr-value">Mutex.new # :nodoc:</td>
|
|
100
|
+
</tr>
|
|
101
|
+
</table>
|
|
102
|
+
|
|
103
|
+
|
|
104
|
+
<div class="sectiontitle">Public Class methods</div>
|
|
105
|
+
<div class="method">
|
|
106
|
+
<div class="title">
|
|
107
|
+
<a name="M000052"></a><b>new</b>(owner_pipe, options = {})
|
|
108
|
+
</div>
|
|
109
|
+
<div class="sourcecode">
|
|
110
|
+
<p class="source-link">[ <a href="javascript:toggleSource('M000052_source')" id="l_M000052_source">show source</a> ]</p>
|
|
111
|
+
<div id="M000052_source" class="dyn-source">
|
|
112
|
+
<pre>
|
|
113
|
+
<span class="ruby-comment cmt"># File lib/phusion_passenger/railz/request_handler.rb, line 37</span>
|
|
114
|
+
37: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">owner_pipe</span>, <span class="ruby-identifier">options</span> = {})
|
|
115
|
+
38: <span class="ruby-keyword kw">super</span>(<span class="ruby-identifier">owner_pipe</span>, <span class="ruby-identifier">options</span>)
|
|
116
|
+
39: <span class="ruby-constant">NINJA_PATCHING_LOCK</span>.<span class="ruby-identifier">synchronize</span> <span class="ruby-keyword kw">do</span>
|
|
117
|
+
40: <span class="ruby-identifier">ninja_patch_action_controller</span>
|
|
118
|
+
41: <span class="ruby-keyword kw">end</span>
|
|
119
|
+
42: <span class="ruby-keyword kw">end</span>
|
|
120
|
+
</pre>
|
|
121
|
+
</div>
|
|
122
|
+
</div>
|
|
123
|
+
</div>
|
|
124
|
+
<div class="sectiontitle">Protected Instance methods</div>
|
|
125
|
+
<div class="method">
|
|
126
|
+
<div class="title">
|
|
127
|
+
<a name="M000053"></a><b>process_request</b>(headers, input, output)
|
|
128
|
+
</div>
|
|
129
|
+
<div class="description">
|
|
130
|
+
<p>
|
|
131
|
+
Overrided method.
|
|
132
|
+
</p>
|
|
133
|
+
</div>
|
|
134
|
+
<div class="sourcecode">
|
|
135
|
+
<p class="source-link">[ <a href="javascript:toggleSource('M000053_source')" id="l_M000053_source">show source</a> ]</p>
|
|
136
|
+
<div id="M000053_source" class="dyn-source">
|
|
137
|
+
<pre>
|
|
138
|
+
<span class="ruby-comment cmt"># File lib/phusion_passenger/railz/request_handler.rb, line 46</span>
|
|
139
|
+
46: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">process_request</span>(<span class="ruby-identifier">headers</span>, <span class="ruby-identifier">input</span>, <span class="ruby-identifier">output</span>)
|
|
140
|
+
47: <span class="ruby-identifier">headers</span>[<span class="ruby-constant">CONTENT_LENGTH</span>] = <span class="ruby-identifier">headers</span>[<span class="ruby-constant">HTTP_CONTENT_LENGTH</span>]
|
|
141
|
+
48: <span class="ruby-identifier">cgi</span> = <span class="ruby-constant">CGIFixed</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">headers</span>, <span class="ruby-identifier">input</span>, <span class="ruby-identifier">output</span>)
|
|
142
|
+
49: <span class="ruby-operator">::</span><span class="ruby-constant">Dispatcher</span>.<span class="ruby-identifier">dispatch</span>(<span class="ruby-identifier">cgi</span>,
|
|
143
|
+
50: <span class="ruby-operator">::</span><span class="ruby-constant">ActionController</span><span class="ruby-operator">::</span><span class="ruby-constant">CgiRequest</span><span class="ruby-operator">::</span><span class="ruby-constant">DEFAULT_SESSION_OPTIONS</span>,
|
|
144
|
+
51: <span class="ruby-identifier">cgi</span>.<span class="ruby-identifier">stdoutput</span>)
|
|
145
|
+
52: <span class="ruby-keyword kw">end</span>
|
|
146
|
+
</pre>
|
|
147
|
+
</div>
|
|
148
|
+
</div>
|
|
149
|
+
</div>
|
|
150
|
+
</div>
|
|
151
|
+
|
|
152
|
+
</div>
|
|
153
|
+
|
|
154
|
+
</body>
|
|
155
|
+
</html>
|
|
@@ -0,0 +1,402 @@
|
|
|
1
|
+
<?xml version="1.0" encoding="iso-8859-1"?>
|
|
2
|
+
<!DOCTYPE html
|
|
3
|
+
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
|
4
|
+
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
5
|
+
<html>
|
|
6
|
+
<head>
|
|
7
|
+
<title>Class: PhusionPassenger::SpawnManager</title>
|
|
8
|
+
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
|
|
9
|
+
<link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
|
|
10
|
+
|
|
11
|
+
<script language="JavaScript" type="text/javascript">
|
|
12
|
+
// <![CDATA[
|
|
13
|
+
|
|
14
|
+
function toggleSource( id )
|
|
15
|
+
{
|
|
16
|
+
var elem
|
|
17
|
+
var link
|
|
18
|
+
|
|
19
|
+
if( document.getElementById )
|
|
20
|
+
{
|
|
21
|
+
elem = document.getElementById( id )
|
|
22
|
+
link = document.getElementById( "l_" + id )
|
|
23
|
+
}
|
|
24
|
+
else if ( document.all )
|
|
25
|
+
{
|
|
26
|
+
elem = eval( "document.all." + id )
|
|
27
|
+
link = eval( "document.all.l_" + id )
|
|
28
|
+
}
|
|
29
|
+
else
|
|
30
|
+
return false;
|
|
31
|
+
|
|
32
|
+
if( elem.style.display == "block" )
|
|
33
|
+
{
|
|
34
|
+
elem.style.display = "none"
|
|
35
|
+
link.innerHTML = "show source"
|
|
36
|
+
}
|
|
37
|
+
else
|
|
38
|
+
{
|
|
39
|
+
elem.style.display = "block"
|
|
40
|
+
link.innerHTML = "hide source"
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
function openCode( url )
|
|
45
|
+
{
|
|
46
|
+
window.open( url, "SOURCE_CODE", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=480,width=750" ).focus();
|
|
47
|
+
}
|
|
48
|
+
// ]]>
|
|
49
|
+
</script>
|
|
50
|
+
</head>
|
|
51
|
+
|
|
52
|
+
<body>
|
|
53
|
+
<table width="100%" border='0' cellpadding='0' cellspacing='0' class='banner'><tr>
|
|
54
|
+
<td class="file-title"><span class="file-title-prefix">Class</span><br />PhusionPassenger::SpawnManager</td>
|
|
55
|
+
<td align="right">
|
|
56
|
+
<table cellspacing="0" cellpadding="2">
|
|
57
|
+
<tr valign="top">
|
|
58
|
+
<td>In:</td>
|
|
59
|
+
<td>
|
|
60
|
+
<a href="../../files/lib/phusion_passenger/spawn_manager_rb.html">lib/phusion_passenger/spawn_manager.rb</a>
|
|
61
|
+
</td>
|
|
62
|
+
</tr>
|
|
63
|
+
<tr>
|
|
64
|
+
<td>Parent:</td>
|
|
65
|
+
<td>
|
|
66
|
+
<a href="AbstractServer.html">
|
|
67
|
+
AbstractServer
|
|
68
|
+
</a>
|
|
69
|
+
</td>
|
|
70
|
+
</tr>
|
|
71
|
+
</table>
|
|
72
|
+
</td>
|
|
73
|
+
</tr>
|
|
74
|
+
</table>
|
|
75
|
+
<!-- banner header -->
|
|
76
|
+
|
|
77
|
+
<div id="bodyContent">
|
|
78
|
+
<div id="content">
|
|
79
|
+
|
|
80
|
+
<div class="description"><p>
|
|
81
|
+
The spawn manager is capable of spawning Ruby on Rails or <a
|
|
82
|
+
href="Rack.html">Rack</a> application instances. It acts like a simple
|
|
83
|
+
fascade for the rest of the spawn manager system.
|
|
84
|
+
</p>
|
|
85
|
+
<p>
|
|
86
|
+
<b>Note</b>: <a href="SpawnManager.html">SpawnManager</a> may only be
|
|
87
|
+
started synchronously with <a
|
|
88
|
+
href="AbstractServer.html#M000131">AbstractServer#start_synchronously</a>.
|
|
89
|
+
Starting asynchronously has not been tested. Don‘t forget to call <a
|
|
90
|
+
href="SpawnManager.html#M000119">cleanup</a> after the server‘s main
|
|
91
|
+
loop has finished.
|
|
92
|
+
</p>
|
|
93
|
+
<h2>Ruby on Rails optimizations</h2>
|
|
94
|
+
<p>
|
|
95
|
+
Spawning a Ruby on Rails application is usually slow. But <a
|
|
96
|
+
href="SpawnManager.html">SpawnManager</a> will preload and cache Ruby on
|
|
97
|
+
Rails frameworks, as well as application code, so subsequent spawns will be
|
|
98
|
+
very fast.
|
|
99
|
+
</p>
|
|
100
|
+
<p>
|
|
101
|
+
Internally, <a href="SpawnManager.html">SpawnManager</a> uses <a
|
|
102
|
+
href="Railz/FrameworkSpawner.html">Railz::FrameworkSpawner</a> to preload
|
|
103
|
+
and cache Ruby on Rails frameworks. <a
|
|
104
|
+
href="Railz/FrameworkSpawner.html">Railz::FrameworkSpawner</a>, in turn,
|
|
105
|
+
uses <a href="Railz/ApplicationSpawner.html">Railz::ApplicationSpawner</a>
|
|
106
|
+
to preload and cache application code.
|
|
107
|
+
</p>
|
|
108
|
+
<p>
|
|
109
|
+
In case you‘re wondering why the namespace is "<a
|
|
110
|
+
href="Railz.html">Railz</a>" and not "Rails": it‘s to
|
|
111
|
+
work around an obscure bug in ActiveSupport‘s Dispatcher.
|
|
112
|
+
</p>
|
|
113
|
+
</div>
|
|
114
|
+
|
|
115
|
+
|
|
116
|
+
|
|
117
|
+
<div class="sectiontitle">Methods</div>
|
|
118
|
+
<ul>
|
|
119
|
+
<li><a href="#M000119">cleanup</a></li>
|
|
120
|
+
<li><a href="#M000116">new</a></li>
|
|
121
|
+
<li><a href="#M000118">reload</a></li>
|
|
122
|
+
<li><a href="#M000117">spawn_application</a></li>
|
|
123
|
+
</ul>
|
|
124
|
+
|
|
125
|
+
<div class="sectiontitle">Included Modules</div>
|
|
126
|
+
<ul>
|
|
127
|
+
<li><a href="Utils.html">Utils</a></li>
|
|
128
|
+
</ul>
|
|
129
|
+
|
|
130
|
+
|
|
131
|
+
|
|
132
|
+
|
|
133
|
+
|
|
134
|
+
<div class="sectiontitle">Public Class methods</div>
|
|
135
|
+
<div class="method">
|
|
136
|
+
<div class="title">
|
|
137
|
+
<a name="M000116"></a><b>new</b>()
|
|
138
|
+
</div>
|
|
139
|
+
<div class="sourcecode">
|
|
140
|
+
<p class="source-link">[ <a href="javascript:toggleSource('M000116_source')" id="l_M000116_source">show source</a> ]</p>
|
|
141
|
+
<div id="M000116_source" class="dyn-source">
|
|
142
|
+
<pre>
|
|
143
|
+
<span class="ruby-comment cmt"># File lib/phusion_passenger/spawn_manager.rb, line 60</span>
|
|
144
|
+
60: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>
|
|
145
|
+
61: <span class="ruby-keyword kw">super</span>()
|
|
146
|
+
62: <span class="ruby-ivar">@spawners</span> = <span class="ruby-constant">AbstractServerCollection</span>.<span class="ruby-identifier">new</span>
|
|
147
|
+
63: <span class="ruby-identifier">define_message_handler</span>(<span class="ruby-identifier">:spawn_application</span>, <span class="ruby-identifier">:handle_spawn_application</span>)
|
|
148
|
+
64: <span class="ruby-identifier">define_message_handler</span>(<span class="ruby-identifier">:reload</span>, <span class="ruby-identifier">:handle_reload</span>)
|
|
149
|
+
65: <span class="ruby-identifier">define_signal_handler</span>(<span class="ruby-value str">'SIGHUP'</span>, <span class="ruby-identifier">:reload</span>)
|
|
150
|
+
66:
|
|
151
|
+
67: <span class="ruby-comment cmt"># Start garbage collector in order to free up some existing</span>
|
|
152
|
+
68: <span class="ruby-comment cmt"># heap slots. This prevents the heap from growing unnecessarily</span>
|
|
153
|
+
69: <span class="ruby-comment cmt"># during the startup phase.</span>
|
|
154
|
+
70: <span class="ruby-constant">GC</span>.<span class="ruby-identifier">start</span>
|
|
155
|
+
71: <span class="ruby-keyword kw">if</span> <span class="ruby-constant">GC</span>.<span class="ruby-identifier">copy_on_write_friendly?</span>
|
|
156
|
+
72: <span class="ruby-comment cmt"># Preload libraries for copy-on-write semantics.</span>
|
|
157
|
+
73: <span class="ruby-identifier">require</span> <span class="ruby-value str">'base64'</span>
|
|
158
|
+
74: <span class="ruby-identifier">require</span> <span class="ruby-value str">'phusion_passenger/application'</span>
|
|
159
|
+
75: <span class="ruby-identifier">require</span> <span class="ruby-value str">'phusion_passenger/railz/framework_spawner'</span>
|
|
160
|
+
76: <span class="ruby-identifier">require</span> <span class="ruby-value str">'phusion_passenger/railz/application_spawner'</span>
|
|
161
|
+
77: <span class="ruby-identifier">require</span> <span class="ruby-value str">'phusion_passenger/rack/application_spawner'</span>
|
|
162
|
+
78: <span class="ruby-identifier">require</span> <span class="ruby-value str">'phusion_passenger/html_template'</span>
|
|
163
|
+
79: <span class="ruby-identifier">require</span> <span class="ruby-value str">'phusion_passenger/platform_info'</span>
|
|
164
|
+
80: <span class="ruby-identifier">require</span> <span class="ruby-value str">'phusion_passenger/exceptions'</span>
|
|
165
|
+
81:
|
|
166
|
+
82: <span class="ruby-comment cmt"># Commonly used libraries.</span>
|
|
167
|
+
83: [<span class="ruby-value str">'mysql'</span>, <span class="ruby-value str">'sqlite3'</span>].<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">lib</span><span class="ruby-operator">|</span>
|
|
168
|
+
84: <span class="ruby-keyword kw">begin</span>
|
|
169
|
+
85: <span class="ruby-identifier">require</span> <span class="ruby-identifier">lib</span>
|
|
170
|
+
86: <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">LoadError</span>
|
|
171
|
+
87: <span class="ruby-comment cmt"># Do nothing; ignore if not present.</span>
|
|
172
|
+
88: <span class="ruby-keyword kw">end</span>
|
|
173
|
+
89: <span class="ruby-keyword kw">end</span>
|
|
174
|
+
90: <span class="ruby-keyword kw">end</span>
|
|
175
|
+
91: <span class="ruby-keyword kw">end</span>
|
|
176
|
+
</pre>
|
|
177
|
+
</div>
|
|
178
|
+
</div>
|
|
179
|
+
</div>
|
|
180
|
+
<div class="sectiontitle">Public Instance methods</div>
|
|
181
|
+
<div class="method">
|
|
182
|
+
<div class="title">
|
|
183
|
+
<a name="M000119"></a><b>cleanup</b>()
|
|
184
|
+
</div>
|
|
185
|
+
<div class="description">
|
|
186
|
+
<p>
|
|
187
|
+
Cleanup resources. Should be called when this <a
|
|
188
|
+
href="SpawnManager.html">SpawnManager</a> is no longer needed.
|
|
189
|
+
</p>
|
|
190
|
+
</div>
|
|
191
|
+
<div class="sourcecode">
|
|
192
|
+
<p class="source-link">[ <a href="javascript:toggleSource('M000119_source')" id="l_M000119_source">show source</a> ]</p>
|
|
193
|
+
<div id="M000119_source" class="dyn-source">
|
|
194
|
+
<pre>
|
|
195
|
+
<span class="ruby-comment cmt"># File lib/phusion_passenger/spawn_manager.rb, line 214</span>
|
|
196
|
+
214: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">cleanup</span>
|
|
197
|
+
215: <span class="ruby-ivar">@spawners</span>.<span class="ruby-identifier">cleanup</span>
|
|
198
|
+
216: <span class="ruby-keyword kw">end</span>
|
|
199
|
+
</pre>
|
|
200
|
+
</div>
|
|
201
|
+
</div>
|
|
202
|
+
</div>
|
|
203
|
+
<div class="method">
|
|
204
|
+
<div class="title">
|
|
205
|
+
<a name="M000118"></a><b>reload</b>(app_root = nil)
|
|
206
|
+
</div>
|
|
207
|
+
<div class="description">
|
|
208
|
+
<p>
|
|
209
|
+
Remove the cached application instances at the given application root. If
|
|
210
|
+
nil is specified as application root, then all cached application instances
|
|
211
|
+
will be removed, no matter the application root.
|
|
212
|
+
</p>
|
|
213
|
+
<p>
|
|
214
|
+
<b>Long description:</b> <a href="Application.html">Application</a> code
|
|
215
|
+
might be cached in memory. But once it a while, it will be necessary to <a
|
|
216
|
+
href="SpawnManager.html#M000118">reload</a> the code for an application,
|
|
217
|
+
such as after deploying a <a href="SpawnManager.html#M000116">new</a>
|
|
218
|
+
version of the application. This method makes sure that any cached
|
|
219
|
+
application code is removed, so that the next time an application instance
|
|
220
|
+
is spawned, the application code will be freshly loaded into memory.
|
|
221
|
+
</p>
|
|
222
|
+
<p>
|
|
223
|
+
Raises AbstractServer::SpawnError if something went wrong.
|
|
224
|
+
</p>
|
|
225
|
+
</div>
|
|
226
|
+
<div class="sourcecode">
|
|
227
|
+
<p class="source-link">[ <a href="javascript:toggleSource('M000118_source')" id="l_M000118_source">show source</a> ]</p>
|
|
228
|
+
<div id="M000118_source" class="dyn-source">
|
|
229
|
+
<pre>
|
|
230
|
+
<span class="ruby-comment cmt"># File lib/phusion_passenger/spawn_manager.rb, line 187</span>
|
|
231
|
+
187: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">reload</span>(<span class="ruby-identifier">app_root</span> = <span class="ruby-keyword kw">nil</span>)
|
|
232
|
+
188: <span class="ruby-ivar">@spawners</span>.<span class="ruby-identifier">synchronize</span> <span class="ruby-keyword kw">do</span>
|
|
233
|
+
189: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">app_root</span>
|
|
234
|
+
190: <span class="ruby-comment cmt"># Delete associated ApplicationSpawner.</span>
|
|
235
|
+
191: <span class="ruby-ivar">@spawners</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-node">"app:#{app_root}"</span>)
|
|
236
|
+
192: <span class="ruby-keyword kw">else</span>
|
|
237
|
+
193: <span class="ruby-comment cmt"># Delete all ApplicationSpawners.</span>
|
|
238
|
+
194: <span class="ruby-identifier">keys_to_delete</span> = []
|
|
239
|
+
195: <span class="ruby-ivar">@spawners</span>.<span class="ruby-identifier">each_pair</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">key</span>, <span class="ruby-identifier">spawner</span><span class="ruby-operator">|</span>
|
|
240
|
+
196: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">spawner</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Railz</span><span class="ruby-operator">::</span><span class="ruby-constant">ApplicationSpawner</span>)
|
|
241
|
+
197: <span class="ruby-identifier">keys_to_delete</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">key</span>
|
|
242
|
+
198: <span class="ruby-keyword kw">end</span>
|
|
243
|
+
199: <span class="ruby-keyword kw">end</span>
|
|
244
|
+
200: <span class="ruby-identifier">keys_to_delete</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">key</span><span class="ruby-operator">|</span>
|
|
245
|
+
201: <span class="ruby-ivar">@spawners</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-identifier">key</span>)
|
|
246
|
+
202: <span class="ruby-keyword kw">end</span>
|
|
247
|
+
203: <span class="ruby-keyword kw">end</span>
|
|
248
|
+
204: <span class="ruby-ivar">@spawners</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">spawner</span><span class="ruby-operator">|</span>
|
|
249
|
+
205: <span class="ruby-comment cmt"># Reload all FrameworkSpawners.</span>
|
|
250
|
+
206: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">spawner</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-identifier">:reload</span>)
|
|
251
|
+
207: <span class="ruby-identifier">spawner</span>.<span class="ruby-identifier">reload</span>(<span class="ruby-identifier">app_root</span>)
|
|
252
|
+
208: <span class="ruby-keyword kw">end</span>
|
|
253
|
+
209: <span class="ruby-keyword kw">end</span>
|
|
254
|
+
210: <span class="ruby-keyword kw">end</span>
|
|
255
|
+
211: <span class="ruby-keyword kw">end</span>
|
|
256
|
+
</pre>
|
|
257
|
+
</div>
|
|
258
|
+
</div>
|
|
259
|
+
</div>
|
|
260
|
+
<div class="method">
|
|
261
|
+
<div class="title">
|
|
262
|
+
<a name="M000117"></a><b>spawn_application</b>(options)
|
|
263
|
+
</div>
|
|
264
|
+
<div class="description">
|
|
265
|
+
<p>
|
|
266
|
+
Spawn an application with the given spawn options. When successful, an <a
|
|
267
|
+
href="Application.html">Application</a> object will be returned, which
|
|
268
|
+
represents the spawned application. At least one option must be given:
|
|
269
|
+
<tt>app_root</tt>. This is the application‘s root folder.
|
|
270
|
+
</p>
|
|
271
|
+
<p>
|
|
272
|
+
Other options are:
|
|
273
|
+
</p>
|
|
274
|
+
<dl>
|
|
275
|
+
<dt>‘lower_privilege’, ‘lowest_user’, ‘environment’, ‘environment_variables’, ‘base_uri’ and ‘print_exceptions‘</dt><dd>See Railz::ApplicationSpawner.new for an explanation of these options.
|
|
276
|
+
|
|
277
|
+
</dd>
|
|
278
|
+
<dt>‘app_type‘</dt><dd>What kind of application is being spawned. Either "rails"
|
|
279
|
+
(default), "rack" or "wsgi".
|
|
280
|
+
|
|
281
|
+
</dd>
|
|
282
|
+
<dt>‘spawn_method‘</dt><dd>May be one of "smart", "smart-lv2" or
|
|
283
|
+
"conservative". When "smart" is specified, <a
|
|
284
|
+
href="SpawnManager.html">SpawnManager</a> will internally cache the code of
|
|
285
|
+
Rails applications, in order to speed up future spawning attempts. This
|
|
286
|
+
implies that, if you‘ve changed the application‘s code, you
|
|
287
|
+
must do one of these things:
|
|
288
|
+
|
|
289
|
+
<ul>
|
|
290
|
+
<li>Restart this <a href="SpawnManager.html">SpawnManager</a> by calling <a
|
|
291
|
+
href="AbstractServer.html#M000132">AbstractServer#stop</a>, then <a
|
|
292
|
+
href="AbstractServer.html#M000130">AbstractServer#start</a>.
|
|
293
|
+
|
|
294
|
+
</li>
|
|
295
|
+
<li>Reload the application by calling <a
|
|
296
|
+
href="SpawnManager.html#M000118">reload</a> with the correct app_root
|
|
297
|
+
argument.
|
|
298
|
+
|
|
299
|
+
</li>
|
|
300
|
+
</ul>
|
|
301
|
+
<p>
|
|
302
|
+
"smart" caches the Rails framework code in a framework spawner
|
|
303
|
+
server, and application code in an application spawner server. Sometimes it
|
|
304
|
+
is desirable to skip the framework spawning and going directly for the
|
|
305
|
+
application spawner instead. The "smart-lv2" method allows you to
|
|
306
|
+
do that.
|
|
307
|
+
</p>
|
|
308
|
+
<p>
|
|
309
|
+
Caching however can be incompatible with some applications. The
|
|
310
|
+
"conservative" spawning method does not involve any caching at
|
|
311
|
+
all. Spawning will be slower, but is guaranteed to be compatible with all
|
|
312
|
+
applications.
|
|
313
|
+
</p>
|
|
314
|
+
<p>
|
|
315
|
+
The default spawn method is "smart-lv2".
|
|
316
|
+
</p>
|
|
317
|
+
</dd>
|
|
318
|
+
<dt>‘framework_spawner_timeout’ and ‘app_spawner_timeout‘</dt><dd>These options allow you to specify the maximum idle timeout, in seconds, of
|
|
319
|
+
the framework spawner servers and application spawner servers that will be
|
|
320
|
+
started under the hood. These options are only used if <tt>app_type</tt>
|
|
321
|
+
equals "rails".
|
|
322
|
+
|
|
323
|
+
<p>
|
|
324
|
+
A timeout of 0 means that the spawner server should never idle timeout. A
|
|
325
|
+
timeout of -1 means that the default timeout value should be used. The
|
|
326
|
+
default value is -1.
|
|
327
|
+
</p>
|
|
328
|
+
</dd>
|
|
329
|
+
</dl>
|
|
330
|
+
<p>
|
|
331
|
+
<b>Exceptions:</b>
|
|
332
|
+
</p>
|
|
333
|
+
<ul>
|
|
334
|
+
<li><a href="InvalidPath.html">InvalidPath</a>: <tt>app_root</tt> doesn‘t
|
|
335
|
+
appear to be a valid Ruby on Rails application root.
|
|
336
|
+
|
|
337
|
+
</li>
|
|
338
|
+
<li><a href="VersionNotFound.html">VersionNotFound</a>: The Ruby on Rails
|
|
339
|
+
framework version that the given application requires is not installed.
|
|
340
|
+
|
|
341
|
+
</li>
|
|
342
|
+
<li><a href="AbstractServer/ServerError.html">AbstractServer::ServerError</a>:
|
|
343
|
+
One of the server processes exited unexpectedly.
|
|
344
|
+
|
|
345
|
+
</li>
|
|
346
|
+
<li><a href="FrameworkInitError.html">FrameworkInitError</a>: The Ruby on Rails
|
|
347
|
+
framework that the application requires could not be loaded.
|
|
348
|
+
|
|
349
|
+
</li>
|
|
350
|
+
<li><a href="AppInitError.html">AppInitError</a>: The application raised an
|
|
351
|
+
exception or called exit() during startup.
|
|
352
|
+
|
|
353
|
+
</li>
|
|
354
|
+
</ul>
|
|
355
|
+
</div>
|
|
356
|
+
<div class="sourcecode">
|
|
357
|
+
<p class="source-link">[ <a href="javascript:toggleSource('M000117_source')" id="l_M000117_source">show source</a> ]</p>
|
|
358
|
+
<div id="M000117_source" class="dyn-source">
|
|
359
|
+
<pre>
|
|
360
|
+
<span class="ruby-comment cmt"># File lib/phusion_passenger/spawn_manager.rb, line 141</span>
|
|
361
|
+
141: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">spawn_application</span>(<span class="ruby-identifier">options</span>)
|
|
362
|
+
142: <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-identifier">options</span>[<span class="ruby-value str">"app_root"</span>]
|
|
363
|
+
143: <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-value str">"The 'app_root' option must be given."</span>
|
|
364
|
+
144: <span class="ruby-keyword kw">end</span>
|
|
365
|
+
145: <span class="ruby-identifier">options</span> = <span class="ruby-identifier">sanitize_spawn_options</span>(<span class="ruby-identifier">options</span>)
|
|
366
|
+
146:
|
|
367
|
+
147: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">options</span>[<span class="ruby-value str">"app_type"</span>] <span class="ruby-operator">==</span> <span class="ruby-value str">"rails"</span>
|
|
368
|
+
148: <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-keyword kw">defined?</span>(<span class="ruby-constant">Railz</span><span class="ruby-operator">::</span><span class="ruby-constant">FrameworkSpawner</span>)
|
|
369
|
+
149: <span class="ruby-identifier">require</span> <span class="ruby-value str">'phusion_passenger/application'</span>
|
|
370
|
+
150: <span class="ruby-identifier">require</span> <span class="ruby-value str">'phusion_passenger/railz/framework_spawner'</span>
|
|
371
|
+
151: <span class="ruby-identifier">require</span> <span class="ruby-value str">'phusion_passenger/railz/application_spawner'</span>
|
|
372
|
+
152: <span class="ruby-keyword kw">end</span>
|
|
373
|
+
153: <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">spawn_rails_application</span>(<span class="ruby-identifier">options</span>)
|
|
374
|
+
154: <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">options</span>[<span class="ruby-value str">"app_type"</span>] <span class="ruby-operator">==</span> <span class="ruby-value str">"rack"</span>
|
|
375
|
+
155: <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-keyword kw">defined?</span>(<span class="ruby-constant">Rack</span><span class="ruby-operator">::</span><span class="ruby-constant">ApplicationSpawner</span>)
|
|
376
|
+
156: <span class="ruby-identifier">require</span> <span class="ruby-value str">'phusion_passenger/rack/application_spawner'</span>
|
|
377
|
+
157: <span class="ruby-keyword kw">end</span>
|
|
378
|
+
158: <span class="ruby-keyword kw">return</span> <span class="ruby-constant">Rack</span><span class="ruby-operator">::</span><span class="ruby-constant">ApplicationSpawner</span>.<span class="ruby-identifier">spawn_application</span>(
|
|
379
|
+
159: <span class="ruby-identifier">options</span>[<span class="ruby-value str">"app_root"</span>], <span class="ruby-identifier">options</span>
|
|
380
|
+
160: )
|
|
381
|
+
161: <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">options</span>[<span class="ruby-value str">"app_type"</span>] <span class="ruby-operator">==</span> <span class="ruby-value str">"wsgi"</span>
|
|
382
|
+
162: <span class="ruby-identifier">require</span> <span class="ruby-value str">'phusion_passenger/wsgi/application_spawner'</span>
|
|
383
|
+
163: <span class="ruby-keyword kw">return</span> <span class="ruby-constant">WSGI</span><span class="ruby-operator">::</span><span class="ruby-constant">ApplicationSpawner</span>.<span class="ruby-identifier">spawn_application</span>(
|
|
384
|
+
164: <span class="ruby-identifier">options</span>[<span class="ruby-value str">"app_root"</span>],
|
|
385
|
+
165: <span class="ruby-identifier">options</span>[<span class="ruby-value str">"lower_privilege"</span>],
|
|
386
|
+
166: <span class="ruby-identifier">options</span>[<span class="ruby-value str">"lowest_user"</span>],
|
|
387
|
+
167: <span class="ruby-identifier">options</span>[<span class="ruby-value str">"environment"</span>]
|
|
388
|
+
168: )
|
|
389
|
+
169: <span class="ruby-keyword kw">else</span>
|
|
390
|
+
170: <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-node">"Unknown 'app_type' value '#{options["app_type"]}'."</span>
|
|
391
|
+
171: <span class="ruby-keyword kw">end</span>
|
|
392
|
+
172: <span class="ruby-keyword kw">end</span>
|
|
393
|
+
</pre>
|
|
394
|
+
</div>
|
|
395
|
+
</div>
|
|
396
|
+
</div>
|
|
397
|
+
</div>
|
|
398
|
+
|
|
399
|
+
</div>
|
|
400
|
+
|
|
401
|
+
</body>
|
|
402
|
+
</html>
|