ChoiceToValueTransformer

__construct(ChoiceListInterface $choiceList)

Параметры

ChoiceListInterface

$choiceList

mixed transform($choice)

Преобразует значение из исходного представления в преобразованное представление.

Этот метод вызывается дважды внутри поля формы:

1. Когда поле формы инициализируется данными, прикреплёнными из источника данных (объект или массив).
2. Когда данные из запроса отправляются с помощью {@link Form::submit()} для преобразования новых входных данных обратно в рендерируемый формат. Например, если у вас есть поле даты и вы отправляете '2009-10-10', вы можете принять это значение, потому что оно легко парсится, но преобразователь все равно записывает "2009/10/10" в поле формы (для дальнейшего отображения или других целей).

Этот метод должен уметь обрабатывать пустые значения. Обычно это будет NULL, но в зависимости от вашей реализации возможны и другие пустые значения (например, пустые строки). Причина этого заключается в том, что преобразователи значений должны быть цепкими. Если метод transform() первого преобразователя значений возвращает NULL, второй преобразователь значений должен уметь обработать это значение.

По соглашению, transform() должен возвращать пустую строку, если передаётся NULL.

Параметры

$choice

Возвращаемое значение

mixed

Значение в преобразованном представлении

Исключения

TransformationFailedException

при неудачном преобразовании

mixed reverseTransform(mixed $value)

Преобразует значение из преобразованного представления в исходное представление.

Этот метод вызывается, когда вызывается {@link Form::submit()} для преобразования данных запроса в приемлемый формат для обработки данных/модельного слоя.

Этот метод должен уметь обрабатывать пустые значения. Обычно это будет пустая строка, но в зависимости от вашей реализации возможны и другие пустые значения (например, NULL). Причина этого заключается в том, что преобразователи значений должны быть цепкими. Если метод reverseTransform() первого преобразователя значений возвращает пустую строку, второй преобразователь значений должен уметь обработать это значение.

По соглашению, reverseTransform() должен возвращать NULL, если передаётся пустая строка.

Параметры

mixed

$value

Значение в преобразованном представлении

Возвращаемое значение

mixed

Значение в исходном представлении

Исключения

TransformationFailedException

при неудачном преобразовании