pfp/php-form-processor

在您的网站上几分钟内创建表单。它具有各种内置验证检查,并可扩展以添加更多功能。

1.0.2 2017-12-22 04:59 UTC

This package is not auto-updated.

Last update: 2024-09-24 19:10:24 UTC


README

PHP表单处理器允许您在几分钟内创建网站上的表单。它具有内置的标准验证检查,并且可以轻松扩展各种类以添加自己的功能。

功能

  • 许多标准验证检查
  • 易于扩展的类,以创建自定义字段
  • 分离的模板文件,便于修改表单的HTML标记
  • Google reCAPTCHA集成

文档

更深入的功能解释请参阅wiki上的页面

安装

PHP表单处理器通过Composer安装。

composer require pfp/php-form-processor

初始化

通过Composer安装后,您必须在初始化表单之前创建字段参数。有关所有可用字段及其参数的完整列表,请参阅字段列表页面。

$fields = array();

$fields['name'] = array(
	'label'    => 'Name',
	'type'     => 'text',
	'required' => true,
	'name'     => 'name',
);

$fields['email'] = array(
	'label'    => 'Email',
	'type'     => 'email',
	'required' => true,
	'name'     => 'email',
);

$fields['body'] = array(
	'label'    => 'Message',
	'type'     => 'textarea',
	'required' => true,
	'name'     => 'body',
);

$form_params = array(
	'fields' => $fields,
);

$form = new Pfp\PhpFormProcessor\form($form_params);

显示表单

创建新的表单对象后,您可以使用render_form方法将其打印出来。

$form->render_form('submissions.php');

提交表单

在提交页面,您必须再次使用相同参数初始化表单对象。您还必须将表单输入数据传递到表单中,以便运行验证函数。

$form->submit_form_data($_POST);

验证

插件为所有字段提供许多验证检查。请参阅wiki上的完整验证函数列表。

错误

在运行submit_form_data方法后,如果存在任何错误,错误和提交的数据将保存在$_SESSION超级全局变量中。

$form->print_errors();

数据检索

submit_form_data之后,可以使用get_field_value方法检索数据。您必须传递在初始化期间设置的从字段数组中的键。

$email = $form->get_field_value('email');