aboutsummaryrefslogtreecommitdiffstats
path: root/guides/source/configuring.md
Commit message (Collapse)AuthorAgeFilesLines
* Ensure Active Record connection consistencyschneems2014-01-091-1/+118
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Currently Active Record can be configured via the environment variable `DATABASE_URL` or by manually injecting a hash of values which is what Rails does, reading in `database.yml` and setting Active Record appropriately. Active Record expects to be able to use `DATABASE_URL` without the use of Rails, and we cannot rip out this functionality without deprecating. This presents a problem though when both config is set, and a `DATABASE_URL` is present. Currently the `DATABASE_URL` should "win" and none of the values in `database.yml` are used. This is somewhat unexpected to me if I were to set values such as `pool` in the `production:` group of `database.yml` they are ignored. There are many ways that active record initiates a connection today: - Stand Alone (without rails) - `rake db:<tasks>` - ActiveRecord.establish_connection - With Rails - `rake db:<tasks>` - `rails <server> | <console>` - `rails dbconsole` We should make all of these behave exactly the same way. The best way to do this is to put all of this logic in one place so it is guaranteed to be used. Here is my prosed matrix of how this behavior should work: ``` No database.yml No DATABASE_URL => Error ``` ``` database.yml present No DATABASE_URL => Use database.yml configuration ``` ``` No database.yml DATABASE_URL present => use DATABASE_URL configuration ``` ``` database.yml present DATABASE_URL present => Merged into `url` sub key. If both specify `url` sub key, the `database.yml` `url` sub key "wins". If other paramaters `adapter` or `database` are specified in YAML, they are discarded as the `url` sub key "wins". ``` ### Implementation Current implementation uses `ActiveRecord::Base.configurations` to resolve and merge all connection information before returning. This is achieved through a utility class: `ActiveRecord::ConnectionHandling::MergeAndResolveDefaultUrlConfig`. To understand the exact behavior of this class, it is best to review the behavior in activerecord/test/cases/connection_adapters/connection_handler_test.rb though it should match the above proposal.
* Automatically maintain test database schemaJon Leighton2014-01-021-0/+2
| | | | | | | | | | | | | | * Move check from generated helper to test_help.rb, so that all applications can benefit * Rather than just raising when the test schema has pending migrations, try to load in the schema and only raise if there are pending migrations afterwards * Opt out of the check by setting config.active_record.maintain_test_schema = false * Deprecate db:test:* tasks. The test helper is now fully responsible for maintaining the test schema, so we don't need rake tasks for this. This is also a speed improvement since we're no longer reloading the test database on every call to "rake test".
* Merge branch 'master' of github.com:lifo/docrailsVijay Dev2013-12-201-1/+3
|\
| * [ci skip] add `assets.raise_runtime_errors` flagschneems2013-12-141-2/+4
| | | | | | | | | | The flag will be used in multiple places to check for errors during runtime if enabled. Source: https://github.com/rails/sprockets-rails/pull/100
* | Update configuring guide with I18n options regarding available localesJared Beck2013-12-191-0/+6
| | | | | | | | | | | | | | Add information about 'available_locales' and 'enforce_available_locales' to the configuring guide. Closes #13202. [ci skip]
* | Wrap 80 columns [ci skip]Rafael Mendonça França2013-12-021-5/+10
| |
* | Add documentation about the Action Dispatch salt configurationRafael Mendonça França2013-12-021-0/+8
| | | | | | | | [ci skip]
* | Use alphabetic orderRafael Mendonça França2013-12-021-2/+2
| | | | | | | | [ci skip]
* | :scissors:Rafael Mendonça França2013-12-021-1/+1
|/ | | | [ci skip]
* added schema_migrations_table_name to ActiveRecord::Base in order that the ↵Jerad Phelps2013-10-271-0/+2
| | | | | | | | | | | | | | | | | | | | name of the schema migrations table can be configured. consolidated test_schema_migrations_table_name tests Added changelog entry edited changelog removed commented lines removed reader ensure the schema migrations table is reset at end of test added entry to configuration guide guides typo and changelog order
* guides: configuring: fixing explanation of :after_initialize hookSebastian Gassner2013-10-011-1/+1
| | | | :after_initialize runs after config/initializers, not before
* fixes incorrect spelling of `action_on_unpermitted_parameters`Jared Beck2013-09-281-1/+1
| | | | See `actionpack/test/controller/parameters/raise_on_unpermitted_params_test.rb`
* Merge branch 'master' of github.com:rails/docrailsVijay Dev2013-09-281-0/+6
|\
| * Added missing active record configurations.wangjohn2013-09-251-0/+6
| |
* | Fixed grammatical typo in configuring.md guide.Roman Kofman2013-09-271-1/+1
| |
* | Add notes about database connection pool [ci skip]Gaurish Sharma2013-09-221-0/+11
| |
* | Fix typos: the indefinite articles(a -> an)SUGINO Yasuhiro2013-09-131-1/+1
|/
* Remove whiny_nils config from the rails guidesCaroline Mota2013-08-261-19/+3
| | | | | | This option was removed from master. [ci skip]
* cleans the guides sources from fancy non-ASCII stuffXavier Noria2013-08-231-8/+8
|
* Merge pull request #10045 from senny/document_relative_url_rootYves Senn2013-08-071-2/+39
|\ | | | | document how to deploy to a subdirectory [ci skip]
| * document how to deploy to a subdirectory. #2992 [ci skip]Yves Senn2013-08-071-2/+39
| |
* | Documment config.log_formatter added on 51aeae91Rafael Mendonça França2013-07-111-0/+2
| | | | | | | | [ci skip]
* | fix "will be ran" and "has began" typos in configuration guidePhilip Dorrell2013-06-201-3/+3
| |
* | Consistent use of one space only after punctuationSunny Ripert2013-05-281-3/+3
| |
* | Update configuration docs for assets.enabled, as it's set true by default in ↵Anuj Dutta2013-05-191-1/+2
| | | | | | | | the configuration and doesn't appear in the config files anymore.
* | Update filter_parameters related docs, as they have been moved to initializers.Anuj Dutta2013-05-191-3/+5
| |
* | Revert "Consistent use of code syntax formatting for boolean values"Xavier Noria2013-05-011-7/+7
| | | | | | | | | | | | Same rationale as previous revert. This reverts commit 887225e69b6cdd27f00cf043c4ac918ca5e18cbf.
* | Revert "Correct formatting for remaining booleans"Xavier Noria2013-05-011-21/+21
| | | | | | | | | | | | | | It is not in the contract that flags have to be singletons, the use of regular font indicates that. This reverts commit 80036f9a5341bd831d125dc684841a8433d92070.
* | Correct formatting for remaining booleansJonathan Roes2013-04-301-21/+21
| |
* | it's Active Record not ActiveRecordYves Senn2013-04-301-1/+1
| | | | | | | | /cc @fxn
* | Consistent use of code syntax formatting for boolean valuesJonathan Roes2013-04-301-7/+7
| |
* | fix formatting typo, + should be `Yves Senn2013-04-031-1/+1
|/
* fix some typosVipul A M2013-03-251-2/+2
|
* remove AR auto-explain (config.auto_explain_threshold_in_seconds)Yves Senn2013-02-241-2/+0
| | | | | | | | | | We discussed that the auto explain feature is rarely used. This PR removes only the automatic explain. You can still display the explain output for any given relation using `ActiveRecord::Relation#explain`. As a side-effect this should also fix the connection problem during asset compilation (#9385). The auto explain initializer in the `ActiveRecord::Railtie` forced a connection.
* Remove BestStandardsSupport referencesrobertomiranda2013-02-011-3/+2
|
* Merge remote-tracking branch 'docrails/master'Xavier Noria2013-01-261-1/+1
|\ | | | | | | | | | | Conflicts: actionpack/lib/action_view/helpers/form_options_helper.rb guides/code/getting_started/app/controllers/comments_controller.rb
| * Replaced documentation for ↵Thomas Drake-Brockman2013-01-201-1/+1
| | | | | | | | config.action_controller.raise_on_unpermitted_parameters with documentation for config.action_controller.action_on_unpermitted_params.
* | Remove old asset tags API from docs, reflecting changes from #7900virusman2013-01-231-32/+0
| |
* | copy-edits 7e6e4f2 [ci skip]Xavier Noria2013-01-211-3/+5
| | | | | | | | | | Capitalization in the title of the section, enumerates the environments in the usual order, adds a paragraph, and tries to use less "you"s.
* | document how to create custom rails environmentsYves Senn2013-01-211-0/+7
| |
* | remove performance tests from the default stackYves Senn2013-01-101-1/+0
|/
* Merge branch 'master' of github.com:lifo/docrailsVijay Dev2013-01-091-1/+3
|\ | | | | | | | | Conflicts: guides/source/getting_started.md
| * prefer american spelling of 'behavior'Gosha Arinich2013-01-071-1/+1
| |
| * Rename raise_on_unexpected_params to raise_on_unpermitted_parameters on the ↵Rafael Mendonça França2013-01-051-1/+1
| | | | | | | | guides
| * Fix typoRafael Mendonça França2013-01-051-1/+1
| |
| * Document new configuration option action_controller.raise_on_unexpected_params.Thomas Drake-Brockman2013-01-051-0/+2
| |
* | Restore original remote_ip algorithm.Andre Arko2013-01-021-1/+1
|/ | | | | | | | | | | Proxy servers add X-Forwarded-For headers, resulting in a list of IPs. We remove trusted IP values, and then take the last given value, assuming that it is the most likely to be the correct, unfaked value. See [1] for a very thorough discussion of why that is the best option we have at the moment. [1]: http://blog.gingerlime.com/2012/rails-ip-spoofing-vulnerabilities-and-protection/ Fixes #7979
* replace AS::BufferedLogger doc mentions with AS::LoggerYves Senn2012-12-251-3/+3
|
* Move background jobs to the 'jobs' branch until fully baked. Not shipping ↵Jeremy Kemper2012-12-211-9/+0
| | | | with Rails 4.0.
* Allow users to choose the timestamp format in the cache keyRafael Mendonça França2012-12-101-0/+2
| | | | | | | This can be done using the class attribute cache_timestamp_format Conflicts: railties/guides/source/configuring.textile