1 | <?php |
||
7 | class SimpleArrayTransformer implements DataTransformerInterface |
||
8 | { |
||
9 | /** |
||
10 | * Transforms a value from the original representation to a transformed representation. |
||
11 | * |
||
12 | * This method is called on two occasions inside a form field: |
||
13 | * |
||
14 | * 1. When the form field is initialized with the data attached from the datasource (object or array). |
||
15 | * 2. When data from a request is submitted using {@link Form::submit()} to transform the new input data |
||
16 | * back into the renderable format. For example if you have a date field and submit '2009-10-10' |
||
17 | * you might accept this value because its easily parsed, but the transformer still writes back |
||
18 | * "2009/10/10" onto the form field (for further displaying or other purposes). |
||
19 | * |
||
20 | * This method must be able to deal with empty values. Usually this will |
||
21 | * be NULL, but depending on your implementation other empty values are |
||
22 | * possible as well (such as empty strings). The reasoning behind this is |
||
23 | * that value transformers must be chainable. If the transform() method |
||
24 | * of the first value transformer outputs NULL, the second value transformer |
||
25 | * must be able to process that value. |
||
26 | * |
||
27 | * By convention, transform() should return an empty string if NULL is |
||
28 | * passed. |
||
29 | * |
||
30 | * @param mixed $value The value in the original representation. |
||
31 | * |
||
32 | * @throws TransformationFailedException When the transformation fails. |
||
33 | * |
||
34 | * @return mixed The value in the transformed representation. |
||
35 | */ |
||
36 | public function transform($value) |
||
46 | |||
47 | /** |
||
48 | * Transforms a value from the transformed representation to its original representation. |
||
49 | * |
||
50 | * This method is called when {@link Form::submit()} is called to transform the requests tainted data |
||
51 | * into an acceptable format for your data processing/model layer. |
||
52 | * |
||
53 | * This method must be able to deal with empty values. Usually this will |
||
54 | * be an empty string, but depending on your implementation other empty |
||
55 | * values are possible as well (such as empty strings). The reasoning behind |
||
56 | * this is that value transformers must be chainable. If the |
||
57 | * reverseTransform() method of the first value transformer outputs an |
||
58 | * empty string, the second value transformer must be able to process that |
||
59 | * value. |
||
60 | * |
||
61 | * By convention, reverseTransform() should return NULL if an empty string |
||
62 | * is passed. |
||
63 | * |
||
64 | * @param mixed $value The value in the transformed representation. |
||
65 | * |
||
66 | * @throws TransformationFailedException When the transformation fails. |
||
67 | * |
||
68 | * @return mixed The value in the original representation. |
||
69 | */ |
||
70 | public function reverseTransform($value) |
||
86 | } |
||
87 |