module ActionController::StrongParameters

Сильные `Parameters`

Предоставляет интерфейс для защиты атрибутов от присваивания конечным пользователем. Благодаря этому параметры Action Controller нельзя использовать для массового присваивания в Active Model, пока они не будут явно перечислены.

Кроме того, параметры можно пометить как обязательные и передать по заранее определённому пути обработки исключения, чтобы без лишних усилий получить 400 Bad Request.

class PeopleController < ActionController::Base
  # Using "Person.create(params[:person])" would raise an
  # ActiveModel::ForbiddenAttributesError exception because it'd
  # be using mass assignment without an explicit permit step.
  # This is the recommended form:
  def create
    Person.create(person_params)
  end

  # This will pass with flying colors as long as there's a person key in the
  # parameters, otherwise it'll raise an ActionController::ParameterMissing
  # exception, which will get caught by ActionController::Base and turned
  # into a 400 Bad Request reply.
  def update
    redirect_to current_account.people.find(params[:id]).tap { |person|
      person.update!(person_params)
    }
  end

  private
    # Using a private method to encapsulate the permissible parameters is
    # a good pattern since you'll be able to reuse the same permit
    # list between create and update. Also, you can specialize this method
    # with per-user checking of permissible attributes.
    def person_params
      params.expect(person: [:name, :age])
    end
end

Чтобы использовать accepts_nested_attributes_for с сильными Parameters, необходимо указать, какие вложенные атрибуты следует разрешить. Возможно, вы захотите разрешить :id и :_destroy; дополнительную информацию см. в ActiveRecord::NestedAttributes.

class Person
  has_many :pets
  accepts_nested_attributes_for :pets
end

class PeopleController < ActionController::Base
  def create
    Person.create(person_params)
  end

  ...

  private

    def person_params
      # It's mandatory to specify the nested attributes that should be permitted.
      # If you use `permit` with just the key that points to the nested attributes hash,
      # it will return an empty hash.
      params.expect(person: [ :name, :age, pets_attributes: [ :id, :name, :category ] ])
    end
end

Дополнительную информацию см. в ActionController::Parameters.expect, ActionController::Parameters.require и ActionController::Parameters.permit.

Публичные методы экземпляра

params () Показать исходный код

# File actionpack/lib/action_controller/metal/strong_parameters.rb, line 1511
def params
  @_params ||= begin
    context = {
      controller: self.class.name,
      action: action_name,
      request: request,
      params: request.filtered_parameters
    }
    Parameters.new(request.parameters, context)
  end
end

Возвращает новый объект ActionController::Parameters, созданный с использованием request.parameters.

params= (value) Показать исходный код

# File actionpack/lib/action_controller/metal/strong_parameters.rb, line 1526
def params=(value)
  @_params = value.is_a?(Hash) ? Parameters.new(value) : value
end

Присваивает заданное значение value хешу params. Если value — это Hash, будет создан объект ActionController::Parameters, инициализированный заданным хешем value.

module ActionController::StrongParameters

Сильные Parameters

Сильные `Parameters`