发布于 2015-08-21 15:17:58 | 309 次阅读 | 评论: 0 | 来源: 网络整理
Phalcon中提供了 PhalconForms组件以方便开发者创建和维护应用中的表单。
下面的例子中展示了基本的使用方法：
<?php
use PhalconFormsForm;
use PhalconFormsElementText;
use PhalconFormsElementSelect;
$form = new Form();
$form->add(new Text("name"));
$form->add(new Text("telephone"));
$form->add(
new Select(
"telephoneType",
array(
'H' => 'Home',
'C' => 'Cell'
)
)
);
可在表单定义时穿插使用表单元素的字义：
<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内部会使用 PhalconTag 生成相应的html项， 第二个参数中可以对一些属性进行设置。
<p>
<label>Name</label>
<?php echo $form->render("name", array('maxlength' => 30, 'placeholder' => 'Type your name')); ?>
</p>
HTML的属性也可以在创建时指定：
<?php
$form->add(
new Text(
"name",
array(
'maxlength' => 30,
'placeholder' => 'Type your name'
)
)
);
从上面的例子我们可以看到表单项也可以在form对象初始化后进行添加。 当然开发者也可以对原有的Form类进行扩展：
<?php
use PhalconFormsForm;
use PhalconFormsElementText;
use PhalconFormsElementSelect;
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'
)
)
)
);
}
}
由于 PhalconFormsForm 实现了 PhalconDIInjectable 接口， 所以开发者可以根据自己的需要访问应用中的服务。
<?php
use PhalconFormsForm;
use PhalconFormsElementText;
use PhalconFormsElementHidden;
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"));
}
}
相关的实体在初始化时添加到表单， 自定义的选项通过构造器传送：
<?php
use PhalconFormsForm;
use PhalconFormsElementText;
use PhalconFormsElementHidden;
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'));
}
}
在表单实例中必须要这样使用：
<?php
$form = new UsersForm(
new Users(),
array(
'edit' => true
)
);
Phalcon表单组件可以和 validation 集成，以提供验证。 开发者要单独为每个html元素提供内置或自定义的验证器。
<?php
use PhalconFormsElementText;
use PhalconValidationValidatorPresenceOf;
use PhalconValidationValidatorStringLength;
$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);
然后， 开发者可以根据用户的输入进行验证：
<?php
if (!$form->isValid($_POST)) {
foreach ($form->getMessages() as $message) {
echo $message, '<br>';
}
}
验证器执行的顺序和注册的顺序一致。
默认情况下，所有的元素产生的消息是放在一起的， 所以开发者可以使用简单的foreach来遍历消息， 开发者可以按照自己的意愿组织输出：
<?php
foreach ($form->getMessages(false) as $attribute => $messages) {
echo 'Messages generated by ', $attribute, ':', "n";
foreach ($messages as $message) {
echo $message, '<br>';
}
}
或获取指定元素的消息：
<?php
foreach ($form->getMessagesFor('name') as $message) {
echo $message, '<br>';
}
表单元素可以在进行验证前先进行过滤， 开发者可以为每个元素设置过滤器：
我们可以把 model/collection/plain 设置到表单对象中， 这样 phalcon 会自动的设置表单元素的值：
<?php
$robot = Robots::findFirst();
$form = new Form($robot);
$form->add(new Text("name"));
$form->add(new Text("year"));
在表单渲染时如果表单项未设置默认值， phalcon会使用对象实体值作为默认值：
<?php echo $form->render('name'); ?>
开发者可以使用下面的方式验证表单及利用用户的输入来设置值：
<?php
$form->bind($_POST, $robot);
// Check if the form is valid
if ($form->isValid()) {
// Save the entity
$robot->save();
}
也可以使用一个简单的类做为对象实体进行参数传递：
<?php
class Preferences
{
public $timezone = 'Europe/Amsterdam';
public $receiveEmails = 'No';
}
使用此类做为对象实体，这样可以使用此类中的值作为表单的默认值：
<?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, 这样可以给开发者更多的自由， 当然也会洽使开发稍麻烦一些，不过这是值得的：
<?php
class Preferences
{
public $timezone;
public $receiveEmails;
public function getTimezone()
{
return 'Europe/Amsterdam';
}
public function getReceiveEmails()
{
return 'No';
}
}
Phalcon提供了一些内置的html元素类， 所有这些元素类仅位于 PhalconFormsElement命名空间下：
| 名称 | 描述 | 示例 |
|---|---|---|
| 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 |
当扩展表单时， 我们可以在表单类中实现验证前操作及验证后操作：
<?php
use PhalconMvcForm;
class ContactForm extends Form
{
public function beforeValidation()
{
}
}
开发者对表单的渲染操作有完全的控制， 下面的的例子展示了如何使用标准方法渲染html元素：
<?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>
或是在登录表单中重用表单类：
<?php
use PhalconFormsForm;
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>';
}
}
视图中：
<?php
echo $element->renderDecorated('name');
echo $element->renderDecorated('telephone');
除了可以使用phalcon提供的html元素以外， 开发者还可以使用自定义的html元素：
<?php
use PhalconFormsElement;
class MyElement extends Element
{
public function render($attributes = null)
{
$html = // ... Produce some HTML
return $html;
}
}
此组件为开发者提供了一个表单管理器， 可以用来注册表单，此组件可以使用服务容器来访问：
<?php
use PhalconFormsManager as FormsManager;
$di['forms'] = function () {
return new FormsManager();
};
表单被添加到表单管理器， 然后设置了唯一的名字：
<?php
$this->forms->set('login', new LoginForm());
使用唯一名， 我们可以在应用的任何地方访问到表单：
<?php
echo $this->forms->get('login')->render();