Rails I18n验证弃用警告

时间：2013-12-03 20:52:26

标签： ruby-on-rails ruby ruby-on-rails-4 deprecated rails-i18n

我刚刚更新到rails 4.0.2，我收到了这个警告：

  

[已弃用] I18n.enforce_available_locales将来默认为true。如果您确实想跳过语言环境的验证，可以设置I18n.enforce_available_locales = false以避免此消息。

将其设置为false是否存在任何安全问题？

5 个答案:

答案 0 :(得分：613)

重要：确保您的应用未使用I18n 0.6.8，它有bug that prevents the configuration to be set correctly。

简短回答

为了使警告静音，请编辑application.rb文件并在Rails::Application正文中包含以下行

config.i18n.enforce_available_locales = true

可能的值是：

  • false ：如果你
    • 想要跳过区域设置验证
    • 不关心语言环境
  • true ：如果你
    • 如果传递了无效的区域设置（或）
      • ，则希望应用程序引发错误
    • 想要默认使用新的Rails行为（或）
    • 关心区域设置验证

注意：

  • 旧的默认行为对应false，而不是true。
  • 如果您要设置config.i18n.default_locale配置或其他i18n设置，请务必在设置config.i18n.enforce_available_locales设置后执行此操作。
  • 如果您使用包含I18n功能的第三方gem，通过Application config对象设置变量可能没有效果。在这种情况下，请使用I18n将其直接设置为I18n.config.enforce_available_locales。

    注意事项

实施例

require File.expand_path('../boot', __FILE__)

# ...

module YouApplication
  class Application < Rails::Application

    # ...

    config.i18n.enforce_available_locales = true
    # or if one of your gem compete for pre-loading, use
    I18n.config.enforce_available_locales = true

    # ...

  end
end

答案很长

现在，在Rails 4（＆gt; = 4.0.2）和Rails 3.2（＆gt; = 3.2.14）中都会显示弃用警告。原因在this commit中解释。

  

实施可用的区域设置

     

当I18n.config.enforce_available_locales为真时，我们会提出一个   如果传递的语言环境不可用，则为I18n :: InvalidLocale异常。

     

默认设置为nil，这将显示弃用错误。

     

如果设置为false，我们将完全跳过强制执行可用的区域设置（旧行为）。

     

这已通过以下方法实施：

     
      
  • I18n.config.default_locale =
    •   
  • I18n.config.locale =
    •   
  • I18n.translate
    •   
  • I18n.localize
    •   
  • I18n.transliterate
    •   

在此更改之前，如果您传递了不受支持的语言环境，如果语言环境有效（即/config/locales文件夹中存在相应的语言环境文件），Rails将静默切换到它，否则语言环境将默认为config.i18n.default_locale配置（默认为：en）。

I18n gem的新版本迫使开发人员更加关注区域设置管理。

将来，行为将发生变化，如果区域设置无效，Rails应用程序将引发错误。

在准备此类更改时（可能会破坏直到今天依赖于静默默认值的多个应用程序），警告会强制您在当前过渡期间明确声明要执行的验证。

要恢复以前的行为，只需将以下配置设置为false

即可 
config.i18n.enforce_available_locales = false

否则，将其设置为true以匹配新的Rails默认值，或者如果您希望在域验证上更加严格，并避免在无效区域设置的情况下切换到默认值。

config.i18n.enforce_available_locales = true

买者

  1. 如果您要设置config.i18n.default_locale配置或使用前面提到的任何方法（default_locale=，locale=，translate等），请确保设置config.i18n.enforce_available_locales设置后执行此操作。否则，弃用警告将继续弹出。 （谢谢Fábio Batista）。

  2. 如果您使用包含I18n功能的第三方宝石，则设置变量可能无效。实际上，问题与前一点中描述的相同，只是稍微难以调试。

    这个问题是优先事项。当您在Rails应用程序中设置配置时，该值不会立即分配给I18n gem。 Rails将每个配置存储在内部对象中，加载依赖项（Railties和第三方gem），然后将配置传递给目标类。如果您在配置分配给I18n之前使用调用任何I18n方法的gem（或Rails插件），那么您将收到警告。

    在这种情况下，您需要跳过Rails堆栈并通过调用

    立即将配置设置为I18n gem 
    I18n.config.enforce_available_locales = true

    而不是

    config.i18n.enforce_available_locales = true

    这个问题很容易证明。尝试生成一个新的空Rails应用，您会发现config.i18n中的application.rb设置正常。

    如果你的应用程序没有，有一种简单的方法来调试罪魁祸首。在系统中找到i18n gem，打开i18n.rb文件并编辑方法enforce_available_locales!以包含语句puts caller.inspect。

    这将导致该方法在调用时打印堆栈跟踪。通过检查堆栈跟踪（在我的例子中，它是Authlogic），您将能够确定哪个gem正在调用它。

    ["/Users/weppos/.rvm/gems/ruby-2.0.0-p247@application/gems/i18n-0.6.9/lib/i18n.rb:150:in `translate'",
 "/Users/weppos/.rvm/gems/ruby-2.0.0-p247@application/gems/authlogic-3.1.0/lib/authlogic/i18n/translator.rb:8:in `translate'",
 "/Users/weppos/.rvm/gems/ruby-2.0.0-p247@application/gems/authlogic-3.1.0/lib/authlogic/i18n.rb:79:in `translate'",
 "/Users/weppos/.rvm/gems/ruby-2.0.0-p247@application/gems/authlogic-3.1.0/lib/authlogic/acts_as_authentic/email.rb:68:in `validates_format_of_email_field_options'",
 "/Users/weppos/.rvm/gems/ruby-2.0.0-p247@application/gems/authlogic-3.1.0/lib/authlogic/acts_as_authentic/email.rb:102:in `block in included'",
 "/Users/weppos/.rvm/gems/ruby-2.0.0-p247@application/gems/authlogic-3.1.0/lib/authlogic/acts_as_authentic/email.rb:99:in `class_eval'",
 "/Users/weppos/.rvm/gems/ruby-2.0.0-p247@application/gems/authlogic-3.1.0/lib/authlogic/acts_as_authentic/email.rb:99:in `included'",
 "/Users/weppos/.rvm/gems/ruby-2.0.0-p247@application/gems/authlogic-3.1.0/lib/authlogic/acts_as_authentic/base.rb:37:in `include'",
 "/Users/weppos/.rvm/gems/ruby-2.0.0-p247@application/gems/authlogic-3.1.0/lib/authlogic/acts_as_authentic/base.rb:37:in `block in acts_as_authentic'",
 "/Users/weppos/.rvm/gems/ruby-2.0.0-p247@application/gems/authlogic-3.1.0/lib/authlogic/acts_as_authentic/base.rb:37:in `each'",
 "/Users/weppos/.rvm/gems/ruby-2.0.0-p247@application/gems/authlogic-3.1.0/lib/authlogic/acts_as_authentic/base.rb:37:in `acts_as_authentic'",
 "/Users/weppos/Projects/application/app/models/user.rb:8:in `<class:User>'",
 "/Users/weppos/Projects/application/app/models/user.rb:1:in `<top (required)>'",

答案 1 :(得分：45)

为了完整起见，请注意您也可以通过在I18n.enforce_available_locales中将true设置为false（或config/application.rb）来消除警告：

require File.expand_path('../boot', __FILE__)
.
.
.
module SampleApp
  class Application < Rails::Application
    .
    .
    .
    I18n.enforce_available_locales = true
    .
    .
    .
  end
end

答案 2 :(得分：15)

I18n.config.enforce_available_locales = true在Rails 3.2.16中为我工作（我把它放在config / application.rb中）

答案 3 :(得分：10)

看起来不那样 - 这是i18n工作方式的先前行为 - 当你要求未实现/可用的语言环境时，新行为（true）将引发错误。

请参阅添加此警告的提交：https://github.com/svenfuchs/i18n/commit/3b6e56e06fd70f6e4507996b017238505e66608c

答案 4 :(得分：0)

如果要关心语言环境，请写入appilcation.rb文件。

config.i18n.enforce_available_locales = true

如果进行区域设置验证，则可以写为false，而不管它。

相关问题
最新问题