123456789_123456789_123456789_123456789_123456789_

Class: Rails::Application::Configuration

Relationships & Source Files
Super Chains via Extension / Inclusion / Inheritance
Class Chain:
Instance Chain:
Inherits: Rails::Engine::Configuration
Defined in: railties/lib/rails/application/configuration.rb

Class Method Summary

Instance Attribute Summary

Instance Method Summary

::Rails::Engine::Configuration - Inherited

#generators

Holds generators configuration:

#paths

::Rails::Railtie::Configuration - Inherited

#after_initialize

Last configurable block to run.

#app_generators

This allows you to modify application’s generators from Railties.

#app_middleware

This allows you to modify the application’s middlewares from Engines.

#before_configuration

First configurable block to run.

#before_eager_load

Third configurable block to run.

#before_initialize

Second configurable block to run.

#eager_load_namespaces

All namespaces that are eager loaded.

#respond_to?,
#to_prepare

Defines generic callbacks to run before #after_initialize.

#to_prepare_blocks

::Array of callbacks defined by #to_prepare.

#watchable_dirs

Add directories that should be watched for change.

#watchable_files

Add files that should be watched for change.

Constructor Details

.newConfiguration

[ GitHub ]

  
# File 'railties/lib/rails/application/configuration.rb', line 24

def initialize(*)
  super
  self.encoding                            = Encoding::UTF_8
  @allow_concurrency                       = nil
  @consider_all_requests_local             = false
  @filter_parameters                       = []
  @filter_redirect                         = []
  @helpers_paths                           = []
  @public_file_server                      = ActiveSupport::OrderedOptions.new
  @public_file_server.enabled              = true
  @public_file_server.index_name           = "index"
  @force_ssl                               = false
  @ssl_options                             = {}
  @session_store                           = nil
  @time_zone                               = "UTC"
  @beginning_of_week                       = :monday
  @log_level                               = :debug
  @generators                              = app_generators
  @cache_store                             = [ :file_store, "#{root}/tmp/cache/" ]
  @railties_order                          = [:all]
  @relative_url_root                       = ENV["RAILS_RELATIVE_URL_ROOT"]
  @reload_classes_only_on_change           = true
  @file_watcher                            = ActiveSupport::FileUpdateChecker
  @exceptions_app                          = nil
  @autoflush_log                           = true
  @log_formatter                           = ActiveSupport::Logger::SimpleFormatter.new
  @eager_load                              = nil
  @secret_token                            = nil
  @secret_key_base                         = nil
  @api_only                                = false
  @debug_exception_response_format         = nil
  @x                                       = Custom.new
  @enable_dependency_loading               = false
  @read_encrypted_secrets                  = false
  @content_security_policy                 = nil
  @content_security_policy_report_only     = false
  @content_security_policy_nonce_generator = nil
  @require_master_key                      = false
  @loaded_config_version                   = nil
end

Dynamic Method Handling

This class handles dynamic methods through the method_missing method in the class Rails::Railtie::Configuration

Instance Attribute Details

#allow_concurrency (rw)

[ GitHub ]

#api_only (rw)

[ GitHub ]

  
# File 'railties/lib/rails/application/configuration.rb', line 22

attr_reader :encoding, :api_only, :loaded_config_version

#api_only=(value) (rw)

[ GitHub ]

  
# File 'railties/lib/rails/application/configuration.rb', line 132

def api_only=(value)
  @api_only = value
  generators.api_only = value

  @debug_exception_response_format ||= :api
end

#asset_host (rw)

[ GitHub ]

#autoflush_log (rw)

[ GitHub ]

#beginning_of_week (rw)

[ GitHub ]

#cache_classes (rw)

[ GitHub ]

#cache_store (rw)

[ GitHub ]

#colorize_logging (rw)

[ GitHub ]

  
# File 'railties/lib/rails/application/configuration.rb', line 197

def colorize_logging
  ActiveSupport::LogSubscriber.colorize_logging
end

#colorize_logging=(val) (rw)

[ GitHub ]

  
# File 'railties/lib/rails/application/configuration.rb', line 201

def colorize_logging=(val)
  ActiveSupport::LogSubscriber.colorize_logging = val
  generators.colorize_logging = val
end

#consider_all_requests_local (rw)

[ GitHub ]

#console (rw)

[ GitHub ]

#content_security_policy_nonce_generator (rw)

[ GitHub ]

#content_security_policy_report_only (rw)

[ GitHub ]

#debug_exception_response_format (rw)

[ GitHub ]

  
# File 'railties/lib/rails/application/configuration.rb', line 139

def debug_exception_response_format
  @debug_exception_response_format || :default
end

#debug_exception_response_format=(value) (rw)

[ GitHub ]

  
# File 'railties/lib/rails/application/configuration.rb', line 143

def debug_exception_response_format=(value)
  @debug_exception_response_format = value
end

#eager_load (rw)

[ GitHub ]

#enable_dependency_loading (rw)

[ GitHub ]

#encoding (rw)

[ GitHub ]

  
# File 'railties/lib/rails/application/configuration.rb', line 22

attr_reader :encoding, :api_only, :loaded_config_version

#encoding=(value) (rw)

[ GitHub ]

  
# File 'railties/lib/rails/application/configuration.rb', line 124

def encoding=(value)
  @encoding = value
  silence_warnings do
    Encoding.default_external = value
    Encoding.default_internal = value
  end
end

#exceptions_app (rw)

[ GitHub ]

#file_watcher (rw)

[ GitHub ]

#filter_parameters (rw)

[ GitHub ]

#filter_redirect (rw)

[ GitHub ]

#force_ssl (rw)

[ GitHub ]

#helpers_paths (rw)

[ GitHub ]

#loaded_config_version (readonly)

[ GitHub ]

  
# File 'railties/lib/rails/application/configuration.rb', line 22

attr_reader :encoding, :api_only, :loaded_config_version

#log_formatter (rw)

[ GitHub ]

#log_level (rw)

[ GitHub ]

#log_tags (rw)

[ GitHub ]

#logger (rw)

[ GitHub ]

#public_file_server (rw)

[ GitHub ]

#railties_order (rw)

[ GitHub ]

#read_encrypted_secrets (rw)

[ GitHub ]

#relative_url_root (rw)

[ GitHub ]

#reload_classes_only_on_change (rw)

[ GitHub ]

#require_master_key (rw)

[ GitHub ]

#secret_key_base (rw)

[ GitHub ]

#secret_token (rw)

[ GitHub ]

#session_options (rw)

[ GitHub ]

#ssl_options (rw)

[ GitHub ]

#time_zone (rw)

[ GitHub ]

#x (rw)

[ GitHub ]

Instance Method Details

#annotations

[ GitHub ]

  
# File 'railties/lib/rails/application/configuration.rb', line 237

def annotations
  SourceAnnotationExtractor::Annotation
end

#content_security_policy(&block)

[ GitHub ]

  
# File 'railties/lib/rails/application/configuration.rb', line 241

def content_security_policy(&block)
  if block_given?
    @content_security_policy = ActionDispatch::ContentSecurityPolicy.new(&block)
  else
    @content_security_policy
  end
end

#database_configuration

Loads and returns the entire raw configuration of database from values stored in config/database.yml.

[ GitHub ]

  
# File 'railties/lib/rails/application/configuration.rb', line 165

def database_configuration
  path = paths["config/database"].existent.first
  yaml = Pathname.new(path) if path

  config = if yaml && yaml.exist?
    require "yaml"
    require "erb"
    loaded_yaml = YAML.load(ERB.new(yaml.read).result) || {}
    shared = loaded_yaml.delete("shared")
    if shared
      loaded_yaml.each do |_k, values|
        values.reverse_merge!(shared)
      end
    end
    Hash.new(shared).merge(loaded_yaml)
  elsif ENV["DATABASE_URL"]
    # Value from ENV['DATABASE_URL'] is set to default database connection
    # by Active Record.
    {}
  else
    raise "Could not load database configuration. No such file - #{paths["config/database"].instance_variable_get(:@paths)}"
  end

  config
rescue Psych::SyntaxError => e
  raise "YAML syntax error occurred while parsing #{paths["config/database"].first}. " \
        "Please note that YAML must be consistently indented using spaces. Tabs are not allowed. " \
        "Error: #{e.message}"
rescue => e
  raise e, "Cannot load database configuration:\n#{e.message}", e.backtrace
end

#load_defaults(target_version)

[ GitHub ]

  
# File 'railties/lib/rails/application/configuration.rb', line 65

def load_defaults(target_version)
  case target_version.to_s
  when "5.0"
    if respond_to?(:action_controller)
      action_controller.per_form_csrf_tokens = true
      action_controller.forgery_protection_origin_check = true
    end

    ActiveSupport.to_time_preserves_timezone = true

    if respond_to?(:active_record)
      active_record.belongs_to_required_by_default = true
    end

    self.ssl_options = { hsts: { subdomains: true } }
  when "5.1"
    load_defaults "5.0"

    if respond_to?(:assets)
      assets.unknown_asset_fallback = false
    end

    if respond_to?(:action_view)
      action_view.form_with_generates_remote_forms = true
    end
  when "5.2"
    load_defaults "5.1"

    if respond_to?(:active_record)
      active_record.cache_versioning = true
      # Remove the temporary load hook from SQLite3Adapter when this is removed
      ActiveSupport.on_load(:active_record_sqlite3adapter) do
        ActiveRecord::ConnectionAdapters::SQLite3Adapter.represent_boolean_as_integer = true
      end
    end

    if respond_to?(:action_dispatch)
      action_dispatch.use_authenticated_cookie_encryption = true
    end

    if respond_to?(:active_support)
      active_support.use_authenticated_message_encryption = true
      active_support.use_sha1_digests = true
    end

    if respond_to?(:action_controller)
      action_controller.default_protect_from_forgery = true
    end

    if respond_to?(:action_view)
      action_view.form_with_generates_ids = true
    end
  else
    raise "Unknown version #{target_version.to_s.inspect}"
  end

  @loaded_config_version = target_version
end

#paths

[ GitHub ]

  
# File 'railties/lib/rails/application/configuration.rb', line 147

def paths
  @paths ||= begin
    paths = super
    paths.add "config/database",    with: "config/database.yml"
    paths.add "config/secrets",     with: "config", glob: "secrets.yml{,.enc}"
    paths.add "config/environment", with: "config/environment.rb"
    paths.add "lib/templates"
    paths.add "log",                with: "log/#{Rails.env}.log"
    paths.add "public"
    paths.add "public/javascripts"
    paths.add "public/stylesheets"
    paths.add "tmp"
    paths
  end
end

#session_store(new_session_store = nil, **options) (readonly)

[ GitHub ]

  
# File 'railties/lib/rails/application/configuration.rb', line 206

def session_store(new_session_store = nil, **options)
  if new_session_store
    if new_session_store == :active_record_store
      begin
        ActionDispatch::Session::ActiveRecordStore
      rescue NameError
        raise "`ActiveRecord::SessionStore` is extracted out of Rails into a gem. " \
          "Please add `activerecord-session_store` to your Gemfile to use it."
      end
    end

    @session_store = new_session_store
    @session_options = options || {}
  else
    case @session_store
    when :disabled
      nil
    when :active_record_store
      ActionDispatch::Session::ActiveRecordStore
    when Symbol
      ActionDispatch::Session.const_get(@session_store.to_s.camelize)
    else
      @session_store
    end
  end
end