表单（Forms） · Phalcon中文文档2.0.6

# 表单（Forms） # 表单（Forms） Phalcon中提供了 Phalcon\\Forms组件以方便开发者创建和维护应用中的表单。下面的例子中展示了基本的使用方法： ``` <pre class="calibre14">``` <?php use Phalcon\Forms\Form; use Phalcon\Forms\Element\Text; use Phalcon\Forms\Element\Select; $form = new Form(); $form->add(new Text("name")); $form->add(new Text("telephone")); $form->add( new Select( "telephoneType", array( 'H' => 'Home', 'C' => 'Cell' ) ) ); ``` ``` 可在表单定义时穿插使用表单元素的字义： ``` <pre class="calibre14">``` <h1>Contacts</h1> <form method="post"> <p> <label>Name</label> <?php echo $form->render("name"); ?> </p> <p> <label>Telephone</label> <?php echo $form->render("telephone"); ?> </p> <p> <label>Type</label> <?php echo $form->render("telephoneType"); ?> </p> <p> <input type="submit" value="Save" /> </p> </form> ``` ``` 开发者可根据需要渲染HTML组件。当使用render()函数时， phalcon内部会使用 [*Phalcon\\Tag*](#) 生成相应的html项，第二个参数中可以对一些属性进行设置。 ``` <pre class="calibre14">``` <p> <label>Name</label> <?php echo $form->render("name", array('maxlength' => 30, 'placeholder' => 'Type your name')); ?> </p> ``` ``` HTML的属性也可以在创建时指定： ``` <pre class="calibre14">``` <?php $form->add( new Text( "name", array( 'maxlength' => 30, 'placeholder' => 'Type your name' ) ) ); ``` ``` ### 初始化表单（Initializing forms）从上面的例子我们可以看到表单项也可以在form对象初始化后进行添加。当然开发者也可以对原有的Form类进行扩展： ``` <pre class="calibre14">``` <?php use Phalcon\Forms\Form; use Phalcon\Forms\Element\Text; use Phalcon\Forms\Element\Select; class ContactForm extends Form { public function initialize() { $this->add(new Text("name")); $this->add(new Text("telephone")); $this->add( new Select( "telephoneType", TelephoneTypes::find(), array( 'using' => array( 'id', 'name' ) ) ) ); } } ``` ``` 由于 [*Phalcon\\Forms\\Form*](#) 实现了 [*Phalcon\\DI\\Injectable*](#) 接口，所以开发者可以根据自己的需要访问应用中的服务。 ``` <pre class="calibre14">``` <?php use Phalcon\Forms\Form; use Phalcon\Forms\Element\Text; use Phalcon\Forms\Element\Hidden; class ContactForm extends Form { /** * This method returns the default value for field 'csrf' */ public function getCsrf() { return $this->security->getToken(); } public function initialize() { // Set the same form as entity $this->setEntity($this); // Add a text element to capture the 'email' $this->add(new Text("email")); // Add a text element to put a hidden csrf $this->add(new Hidden("csrf")); } } ``` ``` 相关的实体在初始化时添加到表单，自定义的选项通过构造器传送： ``` <pre class="calibre14">``` <?php use Phalcon\Forms\Form; use Phalcon\Forms\Element\Text; use Phalcon\Forms\Element\Hidden; class UsersForm extends Form { /** * Forms initializer * * @param Users $user * @param array $options */ public function initialize($user, $options) { if ($options['edit']) { $this->add(new Hidden('id')); } else { $this->add(new Text('id')); } $this->add(new Text('name')); } } ``` ``` 在表单实例中必须要这样使用： ``` <pre class="calibre14">``` <?php $form = new UsersForm( new Users(), array( 'edit' => true ) ); ``` ``` ### 验证（Validation） Phalcon表单组件可以和 [*validation*](#) 集成，以提供验证。开发者要单独为每个html元素提供内置或自定义的验证器。 ``` <pre class="calibre14">``` <?php use Phalcon\Forms\Element\Text; use Phalcon\Validation\Validator\PresenceOf; use Phalcon\Validation\Validator\StringLength; $name = new Text("name"); $name->addValidator( new PresenceOf( array( 'message' => 'The name is required' ) ) ); $name->addValidator( new StringLength( array( 'min' => 10, 'messageMinimum' => 'The name is too short' ) ) ); $form->add($name); ``` ``` 然后，开发者可以根据用户的输入进行验证： ``` <pre class="calibre14">``` <?php if (!$form->isValid($_POST)) { foreach ($form->getMessages() as $message) { echo $message, '<br>'; } } ``` ``` 验证器执行的顺序和注册的顺序一致。默认情况下，所有的元素产生的消息是放在一起的，所以开发者可以使用简单的foreach来遍历消息，开发者可以按照自己的意愿组织输出： ``` <pre class="calibre14">``` <?php foreach ($form->getMessages(false) as $attribute => $messages) { echo 'Messages generated by ', $attribute, ':', "\n"; foreach ($messages as $message) { echo $message, '<br>'; } } ``` ``` 或获取指定元素的消息： ``` <pre class="calibre14">``` <?php foreach ($form->getMessagesFor('name') as $message) { echo $message, '<br>'; } ``` ``` ### 过滤（Filtering）表单元素可以在进行验证前先进行过滤，开发者可以为每个元素设置过滤器： ### 设置用户选项（Setting User Options） ### 表单与实体（Forms + Entities）我们可以把 model/collection/plain 设置到表单对象中，这样 phalcon 会自动的设置表单元素的值： ``` <pre class="calibre14">``` <?php $robot = Robots::findFirst(); $form = new Form($robot); $form->add(new Text("name")); $form->add(new Text("year")); ``` ``` 在表单渲染时如果表单项未设置默认值， phalcon会使用对象实体值作为默认值： ``` <pre class="calibre14">``` <?php echo $form->render('name'); ?> ``` ``` 开发者可以使用下面的方式验证表单及利用用户的输入来设置值： ``` <pre class="calibre14">``` <?php $form->bind($_POST, $robot); // Check if the form is valid if ($form->isValid()) { // Save the entity $robot->save(); } ``` ``` 也可以使用一个简单的类做为对象实体进行参数传递： ``` <pre class="calibre14">``` <?php class Preferences { public $timezone = 'Europe/Amsterdam'; public $receiveEmails = 'No'; } ``` ``` 使用此类做为对象实体，这样可以使用此类中的值作为表单的默认值： ``` <pre class="calibre14">``` <?php $form = new Form(new Preferences()); $form->add( new Select( "timezone", array( 'America/New_York' => 'New York', 'Europe/Amsterdam' => 'Amsterdam', 'America/Sao_Paulo' => 'Sao Paulo', 'Asia/Tokyo' => 'Tokyo' ) ) ); $form->add( new Select( "receiveEmails", array( 'Yes' => 'Yes, please!', 'No' => 'No, thanks' ) ) ); ``` ``` 实体中也可以使用getters, 这样可以给开发者更多的自由，当然也会洽使开发稍麻烦一些，不过这是值得的： ``` <pre class="calibre14">``` <?php class Preferences { public $timezone; public $receiveEmails; public function getTimezone() { return 'Europe/Amsterdam'; } public function getReceiveEmails() { return 'No'; } } ``` ``` ### 表单控件（Form Elements） Phalcon提供了一些内置的html元素类，所有这些元素类仅位于 Phalcon\\Forms\\Element命名空间下：名称描述示例Text产生 INPUT\[type=text\] 项[*Example*](#)Password产生 INPUT\[type=password\] 项[*Example*](#)Select产生 SELECT tag (combo lists) 项[*Example*](#)Check产生 INPUT\[type=check\] 项[*Example*](#)Textarea产生 TEXTAREA 项[*Example*](#)Hidden产生 INPUT\[type=hidden\] 项[*Example*](#)File产生 INPUT\[type=file\] 项[*Example*](#)Date产生 INPUT\[type=date\] 项[*Example*](#)Numeric产生 INPUT\[type=number\] 项[*Example*](#)Submit产生 INPUT\[type=submit\] 项[*Example*](#)### 事件回调（Event Callbacks）当扩展表单时，我们可以在表单类中实现验证前操作及验证后操作： ``` <pre class="calibre14">``` <?php use Phalcon\Mvc\Form; class ContactForm extends Form { public function beforeValidation() { } } ``` ``` ### 渲染表单（Rendering Forms）开发者对表单的渲染操作有完全的控制，下面的的例子展示了如何使用标准方法渲染html元素： ``` <pre class="calibre14">``` <?php <form method="post"> <?php // Traverse the form foreach ($form as $element) { // Get any generated messages for the current element $messages = $form->getMessagesFor($element->getName()); if (count($messages)) { // Print each element echo '<div class="messages">'; foreach ($messages as $message) { echo $message; } echo '</div>'; } echo '<p>'; echo '<label for="', $element->getName(), '">', $element->getLabel(), '</label>'; echo $element; echo '</p>'; } ?> <input type="submit" value="Send"/> </form> ``` ``` 或是在登录表单中重用表单类： ``` <pre class="calibre14">``` <?php use Phalcon\Forms\Form; class ContactForm extends Form { public function initialize() { // ... } public function renderDecorated($name) { $element = $this->get($name); // Get any generated messages for the current element $messages = $this->getMessagesFor($element->getName()); if (count($messages)) { // Print each element echo '<div class="messages">'; foreach ($messages as $message) { echo $this->flash->error($message); } echo '</div>'; } echo '<p>'; echo '<label for="', $element->getName(), '">', $element->getLabel(), '</label>'; echo $element; echo '</p>'; } } ``` ``` 视图中： ``` <pre class="calibre14">``` <?php echo $element->renderDecorated('name'); echo $element->renderDecorated('telephone'); ``` ``` ### 创建表单控件（Creating Form Elements）除了可以使用phalcon提供的html元素以外，开发者还可以使用自定义的html元素： ``` <pre class="calibre14">``` <?php use Phalcon\Forms\Element; class MyElement extends Element { public function render($attributes = null) { $html = // ... Produce some HTML return $html; } } ``` ``` ### 表单管理（Forms Manager）此组件为开发者提供了一个表单管理器，可以用来注册表单，此组件可以使用服务容器来访问： ``` <pre class="calibre14">``` <?php use Phalcon\Forms\Manager as FormsManager; $di['forms'] = function () { return new FormsManager(); }; ``` ``` 表单被添加到表单管理器，然后设置了唯一的名字： ``` <pre class="calibre14">``` <?php $this->forms->set('login', new LoginForm()); ``` ``` 使用唯一名，我们可以在应用的任何地方访问到表单： ``` <pre class="calibre14">``` <?php echo $this->forms->get('login')->render(); ``` ``` ### 外部资源（External Resources) - [Vkuró](http://vokuro.phalconphp.com) 是一个使用表单构建器来创建和维护表单的示例 \[[Github](https://github.com/phalcon/vokuro)\] | - [索引](# "总目录") - [下一页](# "读取配置（Reading Configurations）") | - [上一页](# "验证（Validation）") |