620052a5ba
As usual, forgot to 'bzr add' these. Completes the upgrade to Rails 2.2.2.
438 lines
15 KiB
HTML
438 lines
15 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
|
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
|
|
<title>Configuring Rails Applications</title>
|
|
<!--[if lt IE 8]>
|
|
<script src="http://ie7-js.googlecode.com/svn/version/2.0(beta3)/IE8.js" type="text/javascript"></script>
|
|
<![endif]-->
|
|
<link href="stylesheets/base.css" media="screen" rel="Stylesheet" type="text/css" />
|
|
<link href="stylesheets/forms.css" media="screen" rel="Stylesheet" type="text/css" />
|
|
<link href="stylesheets/more.css" media="screen" rel="Stylesheet" type="text/css" />
|
|
<style type="text/css">
|
|
div#container {
|
|
max-width: 900px;
|
|
padding-bottom: 3em;
|
|
}
|
|
|
|
div#content {
|
|
margin-left: 200px;
|
|
}
|
|
|
|
div#container.notoc {
|
|
max-width: 600px;
|
|
}
|
|
|
|
.notoc div#content {
|
|
margin-left: 0;
|
|
}
|
|
|
|
pre {
|
|
line-height: 1.4em;
|
|
}
|
|
|
|
#content p tt {
|
|
background: #eeeeee;
|
|
border: solid 1px #cccccc;
|
|
padding: 3px;
|
|
}
|
|
|
|
dt {
|
|
font-weight: bold;
|
|
}
|
|
|
|
#content dt tt {
|
|
font-size: 10pt;
|
|
}
|
|
|
|
dd {
|
|
margin-left: 3em;
|
|
}
|
|
|
|
#content dt tt, #content pre tt {
|
|
background: none;
|
|
padding: 0;
|
|
border: 0;
|
|
}
|
|
|
|
#content .olist ol {
|
|
margin-left: 2em;
|
|
}
|
|
|
|
#header {
|
|
position: relative;
|
|
max-width: 840px;
|
|
margin-left: auto;
|
|
margin-right: auto;
|
|
}
|
|
|
|
#header.notoc {
|
|
max-width: 580px;
|
|
}
|
|
|
|
#logo {
|
|
position: absolute;
|
|
left: 10px;
|
|
top: 10px;
|
|
width: 110px;
|
|
height: 140px;
|
|
}
|
|
|
|
div#header h1#site_title {
|
|
background: url('images/ruby_on_rails_by_mike_rundle2.gif') top left no-repeat;
|
|
position: absolute;
|
|
width: 392px;
|
|
height: 55px;
|
|
left: 145px;
|
|
top: 20px;
|
|
margin: 0;
|
|
padding: 0;
|
|
}
|
|
|
|
#site_title span {
|
|
display: none;
|
|
}
|
|
|
|
#site_title_tagline {
|
|
display: none;
|
|
}
|
|
|
|
ul#navMain {
|
|
position: absolute;
|
|
margin: 0;
|
|
padding: 0;
|
|
top: 97px;
|
|
left: 145px;
|
|
}
|
|
|
|
.left-floaty, .right-floaty {
|
|
padding: 15px;
|
|
}
|
|
|
|
.admonitionblock,
|
|
.tableblock {
|
|
margin-left: 1em;
|
|
margin-right: 1em;
|
|
margin-top: 0.25em;
|
|
margin-bottom: 1em;
|
|
}
|
|
|
|
.admonitionblock .icon {
|
|
padding-right: 8px;
|
|
}
|
|
|
|
.admonitionblock .content {
|
|
border: solid 1px #ffda78;
|
|
background: #fffebd;
|
|
padding: 10px;
|
|
padding-top: 8px;
|
|
padding-bottom: 8px;
|
|
}
|
|
|
|
.admonitionblock .title {
|
|
font-size: 140%;
|
|
margin-bottom: 0.5em;
|
|
}
|
|
|
|
.tableblock table {
|
|
border: solid 1px #aaaaff;
|
|
background: #f0f0ff;
|
|
}
|
|
|
|
.tableblock th {
|
|
background: #e0e0e0;
|
|
}
|
|
|
|
.tableblock th,
|
|
.tableblock td {
|
|
padding: 3px;
|
|
padding-left: 5px;
|
|
padding-right: 5px;
|
|
}
|
|
|
|
.sidebarblock {
|
|
margin-top: 0.25em;
|
|
margin: 1em;
|
|
border: solid 1px #ccccbb;
|
|
padding: 8px;
|
|
background: #ffffe0;
|
|
}
|
|
|
|
.sidebarblock .sidebar-title {
|
|
font-size: 140%;
|
|
font-weight: 600;
|
|
margin-bottom: 0.3em;
|
|
}
|
|
|
|
.sidebarblock .sidebar-content > .para:last-child > p {
|
|
margin-bottom: 0;
|
|
}
|
|
|
|
.sidebarblock .sidebar-title a {
|
|
text-decoration: none;
|
|
}
|
|
|
|
.sidebarblock .sidebar-title a:hover {
|
|
text-decoration: underline;
|
|
}
|
|
|
|
</style>
|
|
</head>
|
|
<body>
|
|
<div id="header" >
|
|
<div id="logo">
|
|
<a href="index.html" title="Ruby on Rails"><img src="images/rails_logo_remix.gif" alt="Rails" height="140" width="110" /></a>
|
|
</div>
|
|
|
|
<h1 id="site_title"><span>Ruby on Rails</span></h1>
|
|
<h2 id="site_title_tagline">Sustainable productivity for web-application development</h2>
|
|
|
|
<ul id="navMain">
|
|
<li class="first-child"><a href="http://www.rubyonrails.org/" title="Ruby on Rails" class="ruby_on_rails">Ruby on Rails</a></li>
|
|
<li><a class="manuals" href="index.html" title="Manuals Index">Guides Index</a></li>
|
|
</ul>
|
|
</div>
|
|
|
|
<div id="container">
|
|
|
|
<div id="sidebar">
|
|
<h2>Chapters</h2>
|
|
<ol>
|
|
<li>
|
|
<a href="#_locations_for_initialization_code">Locations for Initialization Code</a>
|
|
</li>
|
|
<li>
|
|
<a href="#_using_a_preinitializer">Using a Preinitializer</a>
|
|
</li>
|
|
<li>
|
|
<a href="#_configuring_rails_components">Configuring Rails Components</a>
|
|
<ul>
|
|
|
|
<li><a href="#_configuring_active_record">Configuring Active Record</a></li>
|
|
|
|
<li><a href="#_configuring_action_controller">Configuring Action Controller</a></li>
|
|
|
|
<li><a href="#_configuring_action_view">Configuring Action View</a></li>
|
|
|
|
<li><a href="#_configuring_action_mailer">Configuring Action Mailer</a></li>
|
|
|
|
<li><a href="#_configuring_active_resource">Configuring Active Resource</a></li>
|
|
|
|
<li><a href="#_configuring_active_support">Configuring Active Support</a></li>
|
|
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<a href="#_using_initializers">Using Initializers</a>
|
|
</li>
|
|
<li>
|
|
<a href="#_using_an_after_initializer">Using an After-Initializer</a>
|
|
</li>
|
|
<li>
|
|
<a href="#_changelog">Changelog</a>
|
|
</li>
|
|
</ol>
|
|
</div>
|
|
|
|
<div id="content">
|
|
<h1>Configuring Rails Applications</h1>
|
|
<div id="preamble">
|
|
<div class="sectionbody">
|
|
<div class="para"><p>This guide covers the configuration and initialization features available to Rails applications. By referring to this guide, you will be able to:</p></div>
|
|
<div class="ilist"><ul>
|
|
<li>
|
|
<p>
|
|
Adjust the behavior of your Rails applications
|
|
</p>
|
|
</li>
|
|
<li>
|
|
<p>
|
|
Add additional code to be run at application start time
|
|
</p>
|
|
</li>
|
|
</ul></div>
|
|
</div>
|
|
</div>
|
|
<h2 id="_locations_for_initialization_code">1. Locations for Initialization Code</h2>
|
|
<div class="sectionbody">
|
|
<div class="para"><p>preinitializers
|
|
environment.rb first
|
|
env-specific files
|
|
initializers (load_application_initializers)
|
|
after-initializer</p></div>
|
|
</div>
|
|
<h2 id="_using_a_preinitializer">2. Using a Preinitializer</h2>
|
|
<div class="sectionbody">
|
|
</div>
|
|
<h2 id="_configuring_rails_components">3. Configuring Rails Components</h2>
|
|
<div class="sectionbody">
|
|
<h3 id="_configuring_active_record">3.1. Configuring Active Record</h3>
|
|
<h3 id="_configuring_action_controller">3.2. Configuring Action Controller</h3>
|
|
<h3 id="_configuring_action_view">3.3. Configuring Action View</h3>
|
|
<h3 id="_configuring_action_mailer">3.4. Configuring Action Mailer</h3>
|
|
<h3 id="_configuring_active_resource">3.5. Configuring Active Resource</h3>
|
|
<h3 id="_configuring_active_support">3.6. Configuring Active Support</h3>
|
|
</div>
|
|
<h2 id="_using_initializers">4. Using Initializers</h2>
|
|
<div class="sectionbody">
|
|
<div class="literalblock">
|
|
<div class="content">
|
|
<pre><tt>organization, controlling load order</tt></pre>
|
|
</div></div>
|
|
</div>
|
|
<h2 id="_using_an_after_initializer">5. Using an After-Initializer</h2>
|
|
<div class="sectionbody">
|
|
</div>
|
|
<h2 id="_changelog">6. Changelog</h2>
|
|
<div class="sectionbody">
|
|
<div class="para"><p><a href="http://rails.lighthouseapp.com/projects/16213-rails-guides/tickets/28">Lighthouse ticket</a></p></div>
|
|
<div class="ilist"><ul>
|
|
<li>
|
|
<p>
|
|
November 5, 2008: Rough outline by <a href="../authors.html#mgunderloy">Mike Gunderloy</a>
|
|
</p>
|
|
</li>
|
|
</ul></div>
|
|
<div class="para"><p>actionmailer/lib/action_mailer/base.rb
|
|
257: cattr_accessor :logger
|
|
267: cattr_accessor :smtp_settings
|
|
273: cattr_accessor :sendmail_settings
|
|
276: cattr_accessor :raise_delivery_errors
|
|
282: cattr_accessor :perform_deliveries
|
|
285: cattr_accessor :deliveries
|
|
288: cattr_accessor :default_charset
|
|
291: cattr_accessor :default_content_type
|
|
294: cattr_accessor :default_mime_version
|
|
297: cattr_accessor :default_implicit_parts_order
|
|
299: cattr_reader :protected_instance_variables</p></div>
|
|
<div class="para"><p>actionmailer/Rakefile
|
|
36: rdoc.options << <em>—line-numbers</em> << <em>—inline-source</em> << <em>-A cattr_accessor=object</em></p></div>
|
|
<div class="para"><p>actionpack/lib/action_controller/base.rb
|
|
263: cattr_reader :protected_instance_variables
|
|
273: cattr_accessor :asset_host
|
|
279: cattr_accessor :consider_all_requests_local
|
|
285: cattr_accessor :allow_concurrency
|
|
317: cattr_accessor :param_parsers
|
|
321: cattr_accessor :default_charset
|
|
325: cattr_accessor :logger
|
|
329: cattr_accessor :resource_action_separator
|
|
333: cattr_accessor :resources_path_names
|
|
337: cattr_accessor :request_forgery_protection_token
|
|
341: cattr_accessor :optimise_named_routes
|
|
351: cattr_accessor :use_accept_header
|
|
361: cattr_accessor :relative_url_root</p></div>
|
|
<div class="para"><p>actionpack/lib/action_controller/caching/pages.rb
|
|
55: cattr_accessor :page_cache_directory
|
|
58: cattr_accessor :page_cache_extension</p></div>
|
|
<div class="para"><p>actionpack/lib/action_controller/caching.rb
|
|
37: cattr_reader :cache_store
|
|
48: cattr_accessor :perform_caching</p></div>
|
|
<div class="para"><p>actionpack/lib/action_controller/dispatcher.rb
|
|
98: cattr_accessor :error_file_path</p></div>
|
|
<div class="para"><p>actionpack/lib/action_controller/mime_type.rb
|
|
24: cattr_reader :html_types, :unverifiable_types</p></div>
|
|
<div class="para"><p>actionpack/lib/action_controller/rescue.rb
|
|
36: base.cattr_accessor :rescue_responses
|
|
40: base.cattr_accessor :rescue_templates</p></div>
|
|
<div class="para"><p>actionpack/lib/action_controller/session/active_record_store.rb
|
|
60: cattr_accessor :data_column_name
|
|
170: cattr_accessor :connection
|
|
173: cattr_accessor :table_name
|
|
177: cattr_accessor :session_id_column
|
|
181: cattr_accessor :data_column
|
|
282: cattr_accessor :session_class</p></div>
|
|
<div class="para"><p>actionpack/lib/action_controller/vendor/html-scanner/html/sanitizer.rb
|
|
44: cattr_accessor :included_tags, :instance_writer ⇒ false</p></div>
|
|
<div class="para"><p>actionpack/lib/action_view/base.rb
|
|
189: cattr_accessor :debug_rjs
|
|
193: cattr_accessor :warn_cache_misses</p></div>
|
|
<div class="para"><p>actionpack/lib/action_view/helpers/active_record_helper.rb
|
|
7: cattr_accessor :field_error_proc</p></div>
|
|
<div class="para"><p>actionpack/lib/action_view/helpers/form_helper.rb
|
|
805: cattr_accessor :default_form_builder</p></div>
|
|
<div class="para"><p>actionpack/lib/action_view/template_handlers/erb.rb
|
|
47: cattr_accessor :erb_trim_mode</p></div>
|
|
<div class="para"><p>actionpack/test/active_record_unit.rb
|
|
5: cattr_accessor :able_to_connect
|
|
6: cattr_accessor :connected</p></div>
|
|
<div class="para"><p>actionpack/test/controller/filters_test.rb
|
|
286: cattr_accessor :execution_log</p></div>
|
|
<div class="para"><p>actionpack/test/template/form_options_helper_test.rb
|
|
3:TZInfo::Timezone.cattr_reader :loaded_zones</p></div>
|
|
<div class="para"><p>activemodel/lib/active_model/errors.rb
|
|
28: cattr_accessor :default_error_messages</p></div>
|
|
<div class="para"><p>activemodel/Rakefile
|
|
19: rdoc.options << <em>—line-numbers</em> << <em>—inline-source</em> << <em>-A cattr_accessor=object</em></p></div>
|
|
<div class="para"><p>activerecord/lib/active_record/attribute_methods.rb
|
|
9: base.cattr_accessor :attribute_types_cached_by_default, :instance_writer ⇒ false
|
|
11: base.cattr_accessor :time_zone_aware_attributes, :instance_writer ⇒ false</p></div>
|
|
<div class="para"><p>activerecord/lib/active_record/base.rb
|
|
394: cattr_accessor :logger, :instance_writer ⇒ false
|
|
443: cattr_accessor :configurations, :instance_writer ⇒ false
|
|
450: cattr_accessor :primary_key_prefix_type, :instance_writer ⇒ false
|
|
456: cattr_accessor :table_name_prefix, :instance_writer ⇒ false
|
|
461: cattr_accessor :table_name_suffix, :instance_writer ⇒ false
|
|
467: cattr_accessor :pluralize_table_names, :instance_writer ⇒ false
|
|
473: cattr_accessor :colorize_logging, :instance_writer ⇒ false
|
|
478: cattr_accessor :default_timezone, :instance_writer ⇒ false
|
|
487: cattr_accessor :schema_format , :instance_writer ⇒ false
|
|
491: cattr_accessor :timestamped_migrations , :instance_writer ⇒ false</p></div>
|
|
<div class="para"><p>activerecord/lib/active_record/connection_adapters/abstract/connection_specification.rb
|
|
11: cattr_accessor :connection_handler, :instance_writer ⇒ false</p></div>
|
|
<div class="para"><p>activerecord/lib/active_record/connection_adapters/mysql_adapter.rb
|
|
166: cattr_accessor :emulate_booleans</p></div>
|
|
<div class="para"><p>activerecord/lib/active_record/fixtures.rb
|
|
498: cattr_accessor :all_loaded_fixtures</p></div>
|
|
<div class="para"><p>activerecord/lib/active_record/locking/optimistic.rb
|
|
38: base.cattr_accessor :lock_optimistically, :instance_writer ⇒ false</p></div>
|
|
<div class="para"><p>activerecord/lib/active_record/migration.rb
|
|
259: cattr_accessor :verbose</p></div>
|
|
<div class="para"><p>activerecord/lib/active_record/schema_dumper.rb
|
|
13: cattr_accessor :ignore_tables</p></div>
|
|
<div class="para"><p>activerecord/lib/active_record/serializers/json_serializer.rb
|
|
4: base.cattr_accessor :include_root_in_json, :instance_writer ⇒ false</p></div>
|
|
<div class="para"><p>activerecord/Rakefile
|
|
142: rdoc.options << <em>—line-numbers</em> << <em>—inline-source</em> << <em>-A cattr_accessor=object</em></p></div>
|
|
<div class="para"><p>activerecord/test/cases/lifecycle_test.rb
|
|
61: cattr_reader :last_inherited</p></div>
|
|
<div class="para"><p>activerecord/test/cases/mixin_test.rb
|
|
9: cattr_accessor :forced_now_time</p></div>
|
|
<div class="para"><p>activeresource/lib/active_resource/base.rb
|
|
206: cattr_accessor :logger</p></div>
|
|
<div class="para"><p>activeresource/Rakefile
|
|
43: rdoc.options << <em>—line-numbers</em> << <em>—inline-source</em> << <em>-A cattr_accessor=object</em></p></div>
|
|
<div class="para"><p>activesupport/lib/active_support/buffered_logger.rb
|
|
17: cattr_accessor :silencer</p></div>
|
|
<div class="para"><p>activesupport/lib/active_support/cache.rb
|
|
81: cattr_accessor :logger</p></div>
|
|
<div class="para"><p>activesupport/lib/active_support/core_ext/class/attribute_accessors.rb
|
|
5:# cattr_accessor :hair_colors
|
|
10: def cattr_reader(*syms)
|
|
29: def cattr_writer(*syms)
|
|
50: def cattr_accessor(*syms)
|
|
51: cattr_reader(*syms)
|
|
52: cattr_writer(*syms)</p></div>
|
|
<div class="para"><p>activesupport/lib/active_support/core_ext/logger.rb
|
|
34: cattr_accessor :silencer</p></div>
|
|
<div class="para"><p>activesupport/test/core_ext/class/attribute_accessor_test.rb
|
|
6: cattr_accessor :foo
|
|
7: cattr_accessor :bar, :instance_writer ⇒ false</p></div>
|
|
<div class="para"><p>activesupport/test/core_ext/module/synchronization_test.rb
|
|
6: @target.cattr_accessor :mutex, :instance_writer ⇒ false</p></div>
|
|
<div class="para"><p>railties/doc/guides/html/creating_plugins.html
|
|
786: cattr_accessor <span style="color: #990000">:</span>yaffle_text_field<span style="color: #990000">,</span> <span style="color: #990000">:</span>yaffle_date_field
|
|
860: cattr_accessor <span style="color: #990000">:</span>yaffle_text_field<span style="color: #990000">,</span> <span style="color: #990000">:</span>yaffle_date_field</p></div>
|
|
<div class="para"><p>railties/lib/rails_generator/base.rb
|
|
93: cattr_accessor :logger</p></div>
|
|
<div class="para"><p>railties/Rakefile
|
|
265: rdoc.options << <em>—line-numbers</em> << <em>—inline-source</em> << <em>—accessor</em> << <em>cattr_accessor=object</em></p></div>
|
|
<div class="para"><p>railties/test/rails_info_controller_test.rb
|
|
12: cattr_accessor :local_request</p></div>
|
|
<div class="para"><p>Rakefile
|
|
32: rdoc.options << <em>-A cattr_accessor=object</em></p></div>
|
|
</div>
|
|
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html>
|