ReversedTransformer

__construct(DataTransformerInterface $reversedTransformer)

Параметры

DataTransformerInterface

$reversedTransformer

mixed transform(mixed $value)

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

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

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

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

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

Параметры

mixed

$value

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

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

mixed

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

Исключения

TransformationFailedException

когда преобразование завершается неудачей

mixed reverseTransform(mixed $value)

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

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

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

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

Параметры

mixed

$value

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

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

mixed

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

Исключения

TransformationFailedException

когда преобразование завершается неудачей