CodeDogg

Model i zasady sprawdzania poprawności wprowadzanych danych

Do sprawdzania zasad poprawności danych wprowadzanych przez użytkowników służy metoda rules(). Określamy w niej np to, które pola są wymagane (required), maksymalną długość dla pół będących ciągami znaków ('length', 'max'=>128), zakresy liczbowe jakie może przyjąć dany atrybut w przypadku gdy jest atrybutem typu liczbowego ('in', 'range'=>array(0, 1, 2)), wzorzec w postaci wyrażenia regularnego jaki musi spełniać dany atrybut ('match', 'pattern'=>'/^[ws,]+$/').

Przykła metody rules() poniżej (na podstawie aplikacji bloga):

public function rules()

{

return array(

array('title, content, status', 'required'),

array('title', 'length', 'max'=>128),

array('status', 'in', 'range'=>array(0, 1, 2)),

array('tags', 'match', 'pattern'=>'/^[ws,]+$/',

'message'=>'Tagi mogą posiadać wyłącznie znaki słów.'),

);

}

Atrybuty, których wartości nie pochodzą od użytkownika a więc nie są wprowadzane w formularzach tylko ustawiane przez aplikację (np. id, createTime, updateTime) nie podlegają sprawdzaniu przez metodę rules(). A więc rules() sprawdza tylko te dane które pochodzą od użytkowników (z formularzy).

Reguły poprawności zawarte w metodzie rules() wykorzystywane są podczas wywołania metody save() lub validate() instancji modelu.

Więcej informacji o budowie reguł walidacji pod tym adresem http://www.yiiframework.com/doc/guide/form.model#declaring-validation-rules