This post comes from the first version of this blog.
Please send me an email if anything needs an update. Thanks!

Witajcie. Dzisiaj po raz kolejny zmierzymy się z frameworkiem symfony, a konkretnie z jego “wewnętrznym frameworkiem” obsługującym formularze. Jak już zdążyliście się dowiedzieć z kilku wcześniejszych wpisów, jest on bardzo wygodnym narzędziem, jednak jeśli się o pewnych rzeczach po prostu nie wie, to niestety potrafi być także złośliwy i ogłupia programistę niezrozumiałymi komunikatami. Tak też właśnie jest z walidatorem pola - sfValidatorChoice, który niestety potrafi zmarnować cenny czas programisty wodząc go za nos komunikatem “Invalid”.

Fotografia: m-a-c, CC-BY.

symfony: sfValidatorChoice i ciągły błąd "Invalid.".

Weźmy pod uwagę prosty przykład:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25

// (...) $options = array( '0' => '14 days', '1' => '7 days', '2' => '3 days', '3' => '1 day', ); $this->setWidgets(array( // (...) 'option' => new sfWidgetFormSelect(array( 'choices' => $options, 'default' => 0, )), // (...) )); // (...) $this->setValidators(array( // (...) 'option' => new sfValidatorChoice( array( 'choices' => $options ), ), // (...) ));

Wydawałoby się, że wszystko jest ok, w końcu podaliśmy do konfiguracji pola opcje w relacjach id => nazwa elementu, a także te same dane do walidatora.

Co jednak otrzymamy? Otóż, niezależnie od tego, co wybierzemy z naszej listy w polu

, walidator zawsze zwróci komunikat “Invalid." - oczywiście może być to dowolna inna, ustawiona przez nas wiadomość, co nie zmienia faktu, że formularz nie ma szans przejść walidacji.

Wydawałoby się, że jeśli sam framework nie prostestuje w kwestii otrzymanej konfiguracji, to wszystko powinno bez problemu się uruchomić i zadziałać według naszych oczekiwań. Nic bardziej błędnego - okazuje się, że dane przekazywane do walidatora są nieco inne niż te, których oczekuje pole formularza. Walidator oczekuje samych “kluczy” z tablicy opcji przekazanych do pola. Należy zatem potraktować rzeczoną tablicę funkcją array_keys() i problem zostaje magicznie rozwiązany:

1
2
3
4
5
6
7
8
9

$this->setValidators(array(
	// (...)
	'option' => new sfValidatorChoice(
		array(
			'choices' => array_keys($options),
			),
		),
	// (...)
	));

Podsumowanie.

Z drugiej strony jednak uważam, że jest to pewna niekonsekwencja, ponieważ przekazanie tych samych danych do pola formularza i walidatora ma sens “logiczny” - jednemu bytowi mówimy: “idź, wyświetl mi ten zbiór danych”, a drugiemu: “słuchaj, sprawdź, czy ten zbiór danych jest poprawny”. Poza tym, w przypadku programisty, który pierwszy raz styka się z tym problemem jest to o wiele bardziej zrozumiałe i przewidywalne, a więc jeden potencjalny problem mniej. Inną sprawą jest to, że posiadając gotową tablicę, możemy ją po prostu wykorzystać w innym miejscu, a wywołanie array_keys() to zawsze trochę czasu i pamięci “do tyłu”. Oczywiście nie namawiam nikogo do tego typu mikrooptymalizacji, aczkolwiek strata kilku mikrosekund bez wyraźnego celu nie będzie nigdy zbyt szczęśliwym rozwiązaniem.

Dziękuję za wspólnie spędzony czas i zapraszam do dyskusji w komentarzach.