Zend_Formの使い方

1. Zend_Form
Z F で モ ダ ン な フ ォ ーム 処 理
2 0 1 2 / 5 / 7

2. PHPカンファレンス北海道2012 / Yusuke Ando (@yando)

3. agenda
Form Basics
Form
Element
Validate

4. Formの処理
Webアプリに頻出する
扱う必要があるタグの種類が豊富
様々なバリデーションも要求される
JavaScriptとの連携も求められる

5. 独自実装は危険
ビューが大量のifやforeachであふれる
基本的な書式チェックでのバグリスク
フォームの仕様は膨らみやすい
ex) 複数選択ドロップダウン
初期値のフィルイン
「ここから選択してください」

6. ライブラリに任せる
PEAR HTML_QuickForm2
ZendFramework Zend_Form
ZendFramework2 ZendFormForm
symfony 1 sfForm
Symfony2 SymfonyComponentForm
FuelPHP FuelCoreForm
CakePHP FormHelper
ライブラリによってバリデーションなどに違い

7. Zend_Form

8. Zend_Form
フォーム全体を担当するZend_Form
各要素はZend_Form_Element
検証はZend_Validate
整形などはZend_Form_Decorator

9. 基本的な流れ
Zend_Formのオブジェクトを作成
必要な入力要素のElementをセット
ElementにValidateをセット
ビューではFormのオブジェクトをecho
コントローラーではFormのisValidで検査

10. とりあえずの例

11. 実行結果
HTMLタグがオブジェクトから自動生成される
（エラーメッセージや、タグのカスタマイズも可能）

12. Element超豊富
Button Multiselect
Captcha Password
Checkbox Radio
File Reset
Hidden Select
Hash Submit
Image Text
MultiCheckbox Textarea

13. この書き方はマズイ

14. サブクラス作成
Zend_Formのサブクラスを作成
オプション設定やElementの生成はinit
再利用性アップ
ユニットテストできるようになる！

15. サブクラス化

16. by splorp
Validate

17. バリデーション
Zend_Validateのオブジェクトを生成
各ElementにaddValidator()する
isValid()にデータを渡して検証
検証済のデータはgetValues()で取得

18. フォームへの設定

19. 検証の実行

20. 実行結果

21. Validatorバリ豊富
Alnum GreaterThan
Alpha Hex
Barcode Hostname
Between Iban
Callback Identical
Cc InArray
CreditCard Int
Date Ip
DB_NoRecordExist Isbn
DB_RecordExist LessThan
Digits NotEmpty
EmailAddress PostCode
File Regex
Float StringLength

22. Validateの自作
Zend_Validate_Interfaceをimplements
したクラスを作成
isValidとgetMessagesを定義
isValid内で任意のロジックで判定
通常と同じくElementへaddValidator

23. Validatorを自作

24. Validatorを設定

25. 実行結果

26. twokingsconfections
Decorator

27. フォームの整形
フォーム全体をrenderした時
要素をrenderした時
自動で様々なタグ付けを行なっている
拡張したり差し替えも可能

28. 要素を直接表示
フォームオブジェクト->要素名を参照
標準では HtmlTag Label Errorsなどが設
定済み
拡張したり差し替えも可能
エラーはgetErrorsで取得する

29. Decoratorを解除

30. 実行結果
後は自由にマークアップを記述すれば良い

31. まとめ
フォームにはZend_Formを使おう
Zend_Formのサブクラスを作る
Zend_Form_Elementで要素を設定
検証はZend_Validate
ビューでは状況に応じて表示

32. サンプル？
https://github.com/yandod/php-form-sample