mirror of
https://github.com/rails/rails.git
synced 2022-11-09 12:12:34 -05:00
Replace 'RAILS_ROOT' to 'Rails.root' and 'RAILS_ENV' to 'Rails.env' in significant places.
This commit is contained in:
parent
41bcf06d32
commit
84e46437fa
11 changed files with 16 additions and 16 deletions
|
@ -41,7 +41,7 @@ module ActionController #:nodoc:
|
|||
##
|
||||
# :singleton-method:
|
||||
# The cache directory should be the document root for the web server and is set using <tt>Base.page_cache_directory = "/document/root"</tt>.
|
||||
# For Rails, this directory has already been set to Rails.public_path (which is usually set to <tt>RAILS_ROOT + "/public"</tt>). Changing
|
||||
# For Rails, this directory has already been set to Rails.public_path (which is usually set to <tt>Rails.root + "/public"</tt>). Changing
|
||||
# this setting can be useful to avoid naming conflicts with files in <tt>public/</tt>, but doing so will likely require configuring your
|
||||
# web server to look in the new location for cached files.
|
||||
@@page_cache_directory = ''
|
||||
|
|
|
@ -183,7 +183,7 @@ Railties generators got a huge amount of attention in Rails 3.0, basically:
|
|||
* Rails templates API and generators API were merged (they are the same as the former).
|
||||
* Generators are no longer loaded from special paths anymore, they are just found in the Ruby load path, so calling <tt>rails generate foo</tt> will look for <tt>generators/foo_generator</tt>.
|
||||
* New generators provide hooks, so any template engine, ORM, test framework can easily hook in.
|
||||
* New generators allow you to override the templates by placing a copy at <tt>RAILS_ROOT/lib/templates</tt>.
|
||||
* New generators allow you to override the templates by placing a copy at <tt>Rails.root/lib/templates</tt>.
|
||||
* <tt>Rails::Generators::TestCase</tt> is also supplied so you can create your own generators and test them.
|
||||
|
||||
Also, the views generated by Railties generators had some overhaul:
|
||||
|
|
|
@ -530,7 +530,7 @@ You can get a list of Rake tasks available to you, which will often depend on yo
|
|||
rake db:abort_if_pending_migrations # Raises an error if there are pending migrations
|
||||
rake db:charset # Retrieves the charset for the current environment's database
|
||||
rake db:collation # Retrieves the collation for the current environment's database
|
||||
rake db:create # Create the database defined in config/database.yml for the current RAILS_ENV
|
||||
rake db:create # Create the database defined in config/database.yml for the current Rails.env
|
||||
...
|
||||
...
|
||||
rake tmp:pids:clear # Clears all files in tmp/pids
|
||||
|
|
|
@ -163,7 +163,7 @@ WARNING: Threadsafe operation in incompatible with the normal workings of develo
|
|||
|
||||
The caching code adds two additional settings:
|
||||
|
||||
* +ActionController::Base.page_cache_directory+ sets the directory where Rails will create cached pages for your web server. The default is +Rails.public_path+ (which is usually set to +RAILS_ROOT + "/public"+).
|
||||
* +ActionController::Base.page_cache_directory+ sets the directory where Rails will create cached pages for your web server. The default is +Rails.public_path+ (which is usually set to +Rails.root + "/public"+).
|
||||
|
||||
* +ActionController::Base.page_cache_extension+ sets the extension to be used when generating pages for the cache (this is ignored if the incoming request already has an extension). The default is +.html+.
|
||||
|
||||
|
|
|
@ -136,7 +136,7 @@ config.logger = Logger.new(STDOUT)
|
|||
config.logger = Log4r::Logger.new("Application Log")
|
||||
</ruby>
|
||||
|
||||
TIP: By default, each log is created under +RAILS_ROOT/log/+ and the log file name is +environment_name.log+.
|
||||
TIP: By default, each log is created under +Rails.root/log/+ and the log file name is +environment_name.log+.
|
||||
|
||||
h4. Log Levels
|
||||
|
||||
|
|
|
@ -103,7 +103,7 @@ The default +environment.rb+ files has instructions on how to add locales from a
|
|||
# The internationalization framework can be changed
|
||||
# to have another default locale (standard is :en) or more load paths.
|
||||
# All files from config/locales/*.rb,yml are added automatically.
|
||||
# config.i18n.load_path << Dir[File.join(RAILS_ROOT, 'my', 'locales', '*.{rb,yml}')]
|
||||
# config.i18n.load_path << Dir[File.join(Rails.root, 'my', 'locales', '*.{rb,yml}')]
|
||||
# config.i18n.default_locale = :de
|
||||
</ruby>
|
||||
|
||||
|
@ -117,7 +117,7 @@ To tell the I18n library where it can find your custom translation files you can
|
|||
# in config/initializers/locale.rb
|
||||
|
||||
# tell the I18n library where to find your translations
|
||||
I18n.load_path << Dir[ File.join(RAILS_ROOT, 'lib', 'locale',
|
||||
I18n.load_path << Dir[ File.join(Rails.root, 'lib', 'locale',
|
||||
'*.{rb,yml}') ]
|
||||
|
||||
# set default locale to something other than :en
|
||||
|
@ -423,7 +423,7 @@ NOTE: The default locale loading mechanism in Rails does not load locale files i
|
|||
|
||||
<ruby>
|
||||
# config/environment.rb
|
||||
config.i18n.load_path += Dir[File.join(RAILS_ROOT, 'config', 'locales', '**', '*.{rb,yml}')]
|
||||
config.i18n.load_path += Dir[File.join(Rails.root, 'config', 'locales', '**', '*.{rb,yml}')]
|
||||
</ruby>
|
||||
|
||||
Do check the "Rails i18n Wiki":http://rails-i18n.org/wiki for list of tools available for managing translations.
|
||||
|
|
|
@ -568,7 +568,7 @@ In many ways this is exactly what it is. This file is created by inspecting the
|
|||
|
||||
There is however a trade-off: +db/schema.rb+ cannot express database specific items such as foreign key constraints, triggers or stored procedures. While in a migration you can execute custom SQL statements, the schema dumper cannot reconstitute those statements from the database. If you are using features like this then you should set the schema format to +:sql+.
|
||||
|
||||
Instead of using Active Record's schema dumper the database's structure will be dumped using a tool specific to that database (via the +db:structure:dump+ Rake task) into +db/#{RAILS_ENV}_structure.sql+. For example for PostgreSQL the +pg_dump+ utility is used and for MySQL this file will contain the output of +SHOW CREATE TABLE+ for the various tables. Loading this schema is simply a question of executing the SQL statements contained inside.
|
||||
Instead of using Active Record's schema dumper the database's structure will be dumped using a tool specific to that database (via the +db:structure:dump+ Rake task) into +db/#{Rails.env}_structure.sql+. For example for PostgreSQL the +pg_dump+ utility is used and for MySQL this file will contain the output of +SHOW CREATE TABLE+ for the various tables. Loading this schema is simply a question of executing the SQL statements contained inside.
|
||||
|
||||
By definition this will be a perfect copy of the database's structure but this will usually prevent loading the schema into a database other than the one used to create it.
|
||||
|
||||
|
|
|
@ -113,7 +113,7 @@ CODE
|
|||
|
||||
Similarly +lib()+ creates a file in the +lib/+ directory and +vendor()+ creates a file in the +vendor/+ directory.
|
||||
|
||||
There is even +file()+, which accepts a relative path from +RAILS_ROOT+ and creates all the directories/file needed :
|
||||
There is even +file()+, which accepts a relative path from +Rails.root+ and creates all the directories/file needed :
|
||||
|
||||
<ruby>
|
||||
file 'app/components/foo.rb', <<-CODE
|
||||
|
|
|
@ -49,7 +49,7 @@ Middlewares used in the code above are primarily useful only in the development
|
|||
|
||||
|_.Middleware|_.Purpose|
|
||||
|+Rails::Rack::LogTailer+|Appends log file output to console|
|
||||
|+ActionDispatch::Static+|Serves static files inside +RAILS_ROOT/public+ directory|
|
||||
|+ActionDispatch::Static+|Serves static files inside +Rails.root/public+ directory|
|
||||
|+Rails::Rack::Debugger+|Starts Debugger|
|
||||
|
||||
h4. +rackup+
|
||||
|
@ -57,7 +57,7 @@ h4. +rackup+
|
|||
To use +rackup+ instead of Rails' +rails server+, you can put the following inside +config.ru+ of your Rails application's root directory:
|
||||
|
||||
<ruby>
|
||||
# RAILS_ROOT/config.ru
|
||||
# Rails.root/config.ru
|
||||
require "config/environment"
|
||||
|
||||
use Rails::Rack::LogTailer
|
||||
|
@ -214,7 +214,7 @@ config.middleware.clear
|
|||
</ruby>
|
||||
|
||||
<br />
|
||||
<strong>Add a +config.ru+ file to +RAILS_ROOT+</strong>
|
||||
<strong>Add a +config.ru+ file to +Rails.root+</strong>
|
||||
|
||||
<ruby>
|
||||
# config.ru
|
||||
|
|
|
@ -53,7 +53,7 @@ module Rails
|
|||
paths.vendor.plugins "vendor/plugins"
|
||||
|
||||
if File.exists?("#{root}/test/mocks/#{Rails.env}")
|
||||
ActiveSupport::Deprecation.warn "\"RAILS_ROOT/test/mocks/#{Rails.env}\" won't be added " <<
|
||||
ActiveSupport::Deprecation.warn "\"Rails.root/test/mocks/#{Rails.env}\" won't be added " <<
|
||||
"automatically to load paths anymore in future releases"
|
||||
paths.mocks_path "test/mocks", :load_path => true, :glob => Rails.env
|
||||
end
|
||||
|
|
|
@ -63,8 +63,8 @@ class DispatchServlet < WEBrick::HTTPServlet::AbstractServlet
|
|||
def initialize(server, options) #:nodoc:
|
||||
@server_options = options
|
||||
@file_handler = WEBrick::HTTPServlet::FileHandler.new(server, options[:server_root])
|
||||
# Change to the RAILS_ROOT, since Webrick::Daemon.start does a Dir::cwd("/")
|
||||
# OPTIONS['working_directory'] is an absolute path of the RAILS_ROOT, set in railties/lib/commands/servers/webrick.rb
|
||||
# Change to the Rails.root, since Webrick::Daemon.start does a Dir::cwd("/")
|
||||
# OPTIONS['working_directory'] is an absolute path of the Rails.root, set in railties/lib/commands/servers/webrick.rb
|
||||
Dir.chdir(OPTIONS['working_directory']) if defined?(OPTIONS) && File.directory?(OPTIONS['working_directory'])
|
||||
super
|
||||
end
|
||||
|
|
Loading…
Reference in a new issue