Rails::Application::Configuration (original) (raw)
Methods
A
C
D
E
L
N
P
R
S
Attributes
[RW] | add_autoload_paths_to_load_path |
---|---|
[RW] | allow_concurrency |
[R] | api_only |
[RW] | asset_host |
[RW] | assume_ssl |
[RW] | autoflush_log |
[RW] | beginning_of_week |
[RW] | cache_classes |
[RW] | cache_store |
[RW] | consider_all_requests_local |
[RW] | console |
[RW] | content_security_policy_nonce_directives |
[RW] | content_security_policy_nonce_generator |
[RW] | content_security_policy_report_only |
[RW] | credentials |
[W] | debug_exception_response_format |
[RW] | disable_sandbox |
[RW] | dom_testing_default_html_version |
[RW] | eager_load |
[R] | encoding |
[RW] | exceptions_app |
[RW] | file_watcher |
[RW] | filter_parameters |
[RW] | filter_redirect |
[RW] | force_ssl |
[RW] | helpers_paths |
[RW] | host_authorization |
[RW] | hosts |
[R] | loaded_config_version |
[RW] | log_file_size |
[RW] | log_formatter |
[R] | log_level |
[RW] | log_tags |
[RW] | logger |
[RW] | precompile_filter_parameters |
[RW] | public_file_server |
[RW] | railties_order |
[RW] | rake_eager_load |
[RW] | relative_url_root |
[RW] | reload_classes_only_on_change |
[RW] | require_master_key |
[RW] | sandbox_by_default |
[RW] | server_timing |
[RW] | session_options |
[RW] | silence_healthcheck_path |
[RW] | ssl_options |
[RW] | time_zone |
[RW] | x |
[RW] | yjit |
Class Public methods
new(*)Link
def initialize(*) super self.encoding = Encoding::UTF_8 @allow_concurrency = nil @consider_all_requests_local = false @filter_parameters = [] @filter_redirect = [] @helpers_paths = [] if Rails.env.development? @hosts = ActionDispatch::HostAuthorization::ALLOWED_HOSTS_IN_DEVELOPMENT + ENV["RAILS_DEVELOPMENT_HOSTS"].to_s.split(",").map(&:strip) else @hosts = [] end @host_authorization = {} @public_file_server = ActiveSupport::OrderedOptions.new @public_file_server.enabled = true @public_file_server.index_name = "index" @assume_ssl = false @force_ssl = false @ssl_options = {} @session_store = nil @time_zone = "UTC" @beginning_of_week = :monday @log_level = :debug @log_file_size = nil @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 @silence_healthcheck_path = nil @eager_load = nil @secret_key_base = nil @api_only = false @debug_exception_response_format = nil @x = Custom.new @content_security_policy = nil @content_security_policy_report_only = false @content_security_policy_nonce_generator = nil @content_security_policy_nonce_directives = nil @require_master_key = false @loaded_config_version = nil @credentials = ActiveSupport::InheritableOptions.new(credentials_defaults) @disable_sandbox = false @sandbox_by_default = false @add_autoload_paths_to_load_path = true @permissions_policy = nil @rake_eager_load = false @server_timing = false @dom_testing_default_html_version = :html4 @yjit = false end
Instance Public methods
annotations()Link
def annotations Rails::SourceAnnotationExtractor::Annotation end
api_only=(value)Link
def api_only=(value) @api_only = value generators.api_only = value
@debug_exception_response_format ||= :api end
autoload_lib(ignore:)Link
def autoload_lib(ignore:) lib = root.join("lib")
autoload_paths << lib.to_s eager_load_paths << lib.to_s
ignored_abspaths = Array.wrap(ignore).map { lib.join(_1) } Rails.autoloaders.main.ignore(ignored_abspaths) end
autoload_lib_once(ignore:)Link
def autoload_lib_once(ignore:) lib = root.join("lib")
autoload_once_paths << lib.to_s eager_load_paths << lib.to_s
ignored_abspaths = Array.wrap(ignore).map { lib.join(_1) } Rails.autoloaders.once.ignore(ignored_abspaths) end
colorize_logging()Link
def colorize_logging ActiveSupport::LogSubscriber.colorize_logging end
colorize_logging=(val)Link
def colorize_logging=(val) ActiveSupport::LogSubscriber.colorize_logging = val generators.colorize_logging = val end
content_security_policy(&block)Link
def content_security_policy(&block) if block_given? @content_security_policy = ActionDispatch::ContentSecurityPolicy.new(&block) else @content_security_policy end end
database_configuration()Link
Loads and returns the entire raw configuration of database from values stored in config/database.yml
.
def database_configuration path = paths["config/database"].existent.first yaml = Pathname.new(path) if path
config = if yaml&.exist? loaded_yaml = ActiveSupport::ConfigurationFile.parse(yaml) if (shared = loaded_yaml.delete("shared")) loaded_yaml.each do |env, config| if config.is_a?(Hash) && config.values.all?(Hash) if shared.is_a?(Hash) && shared.values.all?(Hash) config.map do |name, sub_config| sub_config.reverse_merge!(shared[name]) end else config.map do |name, sub_config| sub_config.reverse_merge!(shared) end end else config.reverse_merge!(shared) end end end Hash.new(shared).merge(loaded_yaml) elsif ENV["DATABASE_URL"]
{}
else raise "Could not load database configuration. No such file - #{paths["config/database"].instance_variable_get(:@paths)}" end
config rescue => e raise e, "Cannot load database configuration:\n#{e.message}", e.backtrace end
debug_exception_response_format()Link
def debug_exception_response_format @debug_exception_response_format || :default end
default_log_file()Link
def default_log_file path = paths["log"].first unless File.exist? File.dirname path FileUtils.mkdir_p File.dirname path end
f = File.open path, "a" f.binmode f.sync = autoflush_log f end
enable_reloading()Link
enable_reloading=(value)Link
def enable_reloading=(value) self.cache_classes = !value end
encoding=(value)Link
def encoding=(value) @encoding = value silence_warnings do Encoding.default_external = value Encoding.default_internal = value end end
load_defaults(target_version)Link
Loads default configuration values for a target version. This includes defaults for versions prior to the target version. See the configuration guide for the default values associated with a particular version.
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
if respond_to?(:active_support)
active_support.to_time_preserves_timezone = :offset
end
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
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.hash_digest_class = OpenSSL::Digest::SHA1
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
when "6.0" load_defaults "5.2"
if respond_to?(:action_view)
action_view.default_enforce_utf8 = false
end
if respond_to?(:action_dispatch)
action_dispatch.use_cookies_with_metadata = true
end
if respond_to?(:action_mailer)
action_mailer.delivery_job = "ActionMailer::MailDeliveryJob"
end
if respond_to?(:active_storage)
active_storage.queues.analysis = :active_storage_analysis
active_storage.queues.purge = :active_storage_purge
end
if respond_to?(:active_record)
active_record.collection_cache_versioning = true
end
when "6.1" load_defaults "6.0"
if respond_to?(:active_record)
active_record.has_many_inversing = true
end
if respond_to?(:active_job)
active_job.retry_jitter = 0.15
end
if respond_to?(:action_dispatch)
action_dispatch.cookies_same_site_protection = :lax
action_dispatch.ssl_default_redirect_status = 308
end
if respond_to?(:action_view)
action_view.form_with_generates_remote_forms = false
action_view.preload_links_header = true
end
if respond_to?(:active_storage)
active_storage.track_variants = true
active_storage.queues.analysis = nil
active_storage.queues.purge = nil
end
if respond_to?(:action_mailbox)
action_mailbox.queues.incineration = nil
action_mailbox.queues.routing = nil
end
if respond_to?(:action_mailer)
action_mailer.deliver_later_queue_name = nil
end
ActiveSupport.utc_to_local_returns_utc_offset_times = true
when "7.0" load_defaults "6.1"
if respond_to?(:action_dispatch)
action_dispatch.default_headers = {
"X-Frame-Options" => "SAMEORIGIN",
"X-XSS-Protection" => "0",
"X-Content-Type-Options" => "nosniff",
"X-Download-Options" => "noopen",
"X-Permitted-Cross-Domain-Policies" => "none",
"Referrer-Policy" => "strict-origin-when-cross-origin"
}
action_dispatch.cookies_serializer = :json
end
if respond_to?(:action_view)
action_view.button_to_generates_button_tag = true
action_view.apply_stylesheet_media_default = false
end
if respond_to?(:active_support)
active_support.hash_digest_class = OpenSSL::Digest::SHA256
active_support.key_generator_hash_digest_class = OpenSSL::Digest::SHA256
active_support.cache_format_version = 7.0
active_support.executor_around_test_case = true
end
if respond_to?(:action_mailer)
action_mailer.smtp_timeout = 5
end
if respond_to?(:active_storage)
active_storage.video_preview_arguments =
"-vf 'select=eq(n\\,0)+eq(key\\,1)+gt(scene\\,0.015),loop=loop=-1:size=2,trim=start_frame=1'" \
" -frames:v 1 -f image2"
active_storage.variant_processor = :vips
active_storage.multiple_file_field_include_hidden = true
end
if respond_to?(:active_record)
active_record.verify_foreign_keys_for_fixtures = true
active_record.partial_inserts = false
active_record.automatic_scope_inversing = true
end
if respond_to?(:action_controller)
action_controller.raise_on_open_redirects = true
action_controller.wrap_parameters_by_default = true
end
when "7.1" load_defaults "7.0"
self.add_autoload_paths_to_load_path = false
self.precompile_filter_parameters = true
self.dom_testing_default_html_version = defined?(Nokogiri::HTML5) ? :html5 : :html4
if Rails.env.local?
self.log_file_size = 100 * 1024 * 1024
end
if respond_to?(:active_record)
active_record.run_commit_callbacks_on_first_saved_instances_in_transaction = false
active_record.sqlite3_adapter_strict_strings_by_default = true
active_record.query_log_tags_format = :sqlcommenter
active_record.raise_on_assign_to_attr_readonly = true
active_record.belongs_to_required_validates_foreign_key = false
active_record.before_committed_on_all_records = true
active_record.default_column_serializer = nil
active_record.encryption.hash_digest_class = OpenSSL::Digest::SHA256
active_record.encryption.support_sha1_for_non_deterministic_encryption = false
active_record.marshalling_format_version = 7.1
active_record.run_after_transaction_callbacks_in_order_defined = true
active_record.generate_secure_token_on = :initialize
end
if respond_to?(:action_dispatch)
action_dispatch.default_headers = {
"X-Frame-Options" => "SAMEORIGIN",
"X-XSS-Protection" => "0",
"X-Content-Type-Options" => "nosniff",
"X-Permitted-Cross-Domain-Policies" => "none",
"Referrer-Policy" => "strict-origin-when-cross-origin"
}
action_dispatch.debug_exception_log_level = :error
end
if respond_to?(:active_support)
active_support.cache_format_version = 7.1
active_support.message_serializer = :json_allow_marshal
active_support.use_message_serializer_for_metadata = true
active_support.raise_on_invalid_cache_expiration_time = true
end
if respond_to?(:action_view)
require "action_view/helpers"
action_view.sanitizer_vendor = Rails::HTML::Sanitizer.best_supported_vendor
end
if respond_to?(:action_text)
require "action_view/helpers"
action_text.sanitizer_vendor = Rails::HTML::Sanitizer.best_supported_vendor
end
when "7.2" load_defaults "7.1"
self.yjit = true
if respond_to?(:active_storage)
active_storage.web_image_content_types = %w( image/png image/jpeg image/gif image/webp )
end
if respond_to?(:active_record)
active_record.postgresql_adapter_decode_dates = true
active_record.validate_migration_timestamps = true
end
when "8.0" load_defaults "7.2"
if respond_to?(:active_support)
active_support.to_time_preserves_timezone = :zone
end
if respond_to?(:action_dispatch)
action_dispatch.strict_freshness = true
end
Regexp.timeout ||= 1 if Regexp.respond_to?(:timeout=)
else raise "Unknown version #{target_version.to_s.inspect}" end
@loaded_config_version = target_version end
log_level=(level)Link
def log_level=(level) @log_level = level @broadcast_log_level = level end
paths()Link
def paths @paths ||= begin paths = super paths.add "config/database", with: "config/database.yml" 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
permissions_policy(&block)Link
def permissions_policy(&block) if block_given? @permissions_policy = ActionDispatch::PermissionsPolicy.new(&block) else @permissions_policy end end
reloading_enabled?()Link
def reloading_enabled? enable_reloading end
secret_key_base()Link
def secret_key_base @secret_key_base || begin self.secret_key_base = if ENV["SECRET_KEY_BASE_DUMMY"] generate_local_secret else ENV["SECRET_KEY_BASE"] || Rails.application.credentials.secret_key_base || (Rails.env.local? && generate_local_secret) end end end
secret_key_base=(new_secret_key_base)Link
def secret_key_base=(new_secret_key_base)
if new_secret_key_base.nil? && Rails.env.local?
@secret_key_base = generate_local_secret
elsif new_secret_key_base.is_a?(String) && new_secret_key_base.present?
@secret_key_base = new_secret_key_base
elsif new_secret_key_base
raise ArgumentError, "secret_key_base
for #{Rails.env} environment must be a type of String" else raise ArgumentError, "Missing
secret_key_basefor '#{Rails.env}' environment, set this string with
bin/rails credentials:edit`"
end
end
session_store(new_session_store = nil, **options)Link
Specifies what class to use to store the session. Possible values are :cache_store
, :cookie_store
, :mem_cache_store
, a custom store, or :disabled
. :disabled
tells Rails not to deal with sessions.
Additional options will be set as session_options:
config.session_store :cookie_store, key: "_your_app_session"
config.session_options # => {key: "_your_app_session"}
If a custom store is specified as a symbol, it will be resolved to the ActionDispatch::Session namespace:
# use ActionDispatch::Session::MyCustomStore as the session store
config.session_store :my_custom_store
def session_store(new_session_store = nil, **options) if new_session_store @session_store = new_session_store @session_options = options || {} else case @session_store when :disabled nil when Symbol ActionDispatch::Session.resolve_store(@session_store) else @session_store end end end