首页 开发教程 正文
我要发布

Formidable

开发教程
2025-12-07 0 283

Formidable

Formidable是一个可以处理表单的PHP库。它解析了HTML表单，并允许您从PHP代码中操作它，然后渲染它。

它如何工作？

步骤1：下载并安装Formidable

通过作曲家：

Formidable\”: \”dev–master\”
}
}\”>

{
    \"require\" : {
        \"gregwar/ Formidable \" : \" dev-master \"
    }
}

或带有存储库的克隆： 

git clone https://githu*b*.c*om/Gregwar/Formidable.git

或下载它：

  • 下载.zip
  • 下载.tar.gz

步骤2：在HTML中写下您的表格

首先，您必须在HTML中编写代码，例如：

<form method=\”post\”>
Enter your name:
<input type=\”text\” name=\”name\” /><br />
<input type=\”submit\” />
</form>\’>

 <!-- forms/example.html -->
< form method =\" post \" >
    Enter your name: 
    < input type =\" text \" name =\" name \" /> < br />
    < input type =\" submit \" />
</ form >

步骤3：给它Formidable

在您的php代码中，将您的表格赋予Formidable ：

Formidable will parse the form and use it to check integrity
// on the server-side
$form = new Gregwar\\ Formidable \\Form(\’forms/example.html\’);

$form->handle(function() {
echo \”Form OK!\”;
}, function($errors) {
echo \”Errors: <br/>\”;
foreach ($errors as $error) {
echo \”$error<br />\”;
}
});

echo $form;\”>

 <?php
session_start ();
include ( \' vendor/autoload.php \' );

// Formidable will parse the form and use it to check integrity
// on the server-side
$ form = new Gregwar \\ Formidable \\ Form ( \' forms/example.html \' );

$ form -> handle ( function () {
    echo \" Form OK! \" ;
}, function ( $ errors ) {
    echo \" Errors: <br/> \" ;
    foreach ( $ errors as $ error ) {
        echo \" $ error <br /> \" ;
    }
});

echo $ form ;

简单，对吗？

步骤4：享受魔术

然后，您可以使用Formidable API播放您的表格： 

 <?php

// Will set the value of the field
$ form -> name = \" Bob \" ;

// Will get the value of the field
$ name = $ form -> name ;

// Adds a constraint on the name
$ form -> addConstraint ( \' name \' , function ( $ value ) {
    if ( strlen ( $ value ) < 10 ) {
        return \' Your name should be at least 10 characters! \' ;
    }
});

// Adds a constraint on the whole form
$ form -> addConstraint ( function ( $ form ) {
    if ( $ form -> getValue ( \' pass1 \' ) != $ form -> getValue ( \' pass2 \' )) {
        return \' The passwords are different \' ;
    }
});

您也可以尝试更改表单并直接在HTML代码中添加约束： 

 < input type =\" text \" name =\" name \" minlength =\" 10 \" />

当将检查服务器端约束时，这将迫使文本至少长10个字符。

想要验证码来保护您的表格吗？ 

 < input type =\" captcha \" name =\" code \" />

这将在客户端上生成图像和输入字段，并在服务器端上使用会话来检查代码是否正确。

请注意，这将使用Gregwar/Captcha库的依赖关系（您必须使用Composer安装依赖项）。

类型

支持以下输入类型：

  • input标签，具有类型：
    • text
    • number或numeric ，请参阅min和max属性
    • int或integer ，请参阅min和max属性
    • file
    • checkbox
    • radio
    • hidden
    • password
    • captcha ，将自动生成图像
    • date ，将生成三个选择，并将DateTime作为数据返回
    • multiradio和multicheckbox （请参阅源部分）
  • textarea
  • select

属性

请注意，某些属性不是html-valid，例如maxlength ： 

 < input type =\" text \" name =\" name \" maxlength =\" 10 \" />

它不会以HTML形式渲染，但将用于检查完整性。

这是可用属性的列表：

  • minlength ：值的最小长度
  • maxlength ：值的最大长度
  • regex ：值应尊重的正则
  • min （数字）：最小值
  • max （数字）：最大值
  • required ：说明该字段是必需的
  • readonly ：该字段已阅读，不应是修饰符
  • value ：该字段的默认值
  • min-entries ：指定您应该提供多个的最小条目数（请参见下文）
  • max-entries ：指定您可以提供多个的最大条目数（请参见下文）
  • entries ：指定多个倍数的最小条目和最大条目数（见下文）

API

您可以在$form对象上调用这些方法：

  • posted() ：返回true如果表格发布
  • check() ：检查表格并返回有效性错误的数组
  • handle($callback, $errorCallback) ，此快捷方式呼叫发布并检查（），并且如果表格有效，将调用$callback ， $errorCallback else
  • setAttribute($field, $attr, $value) ：在字段上设置一个额外属性
  • getAttribute($field, $attr) ：在字段上获取一个额外的属性
  • source($source, $values) ：馈送源（请参阅“源”部分）
  • setPlaceholder($name, $value) ：设置一个占位符价值（见下文）
  • addConstraint($field, $callback) ：在字段上添加自定义约束，将带有字段值调用callback ，如果没有问题，则应返回false或错误字符串。如果您只是通过封闭，则将闭合以作为参数传递的表格来调用，然后可以进行一些涉及多个字段或表单信息的测试。
  • setValue($field, $value) ：设置字段的值
  • getValue($field) ：获取字段的值
  • setValues(array $values) ：设置某些字段的值
  • getValues() ：获取所有字段的值

CSRF保护

额外的CSRF令牌会自动以表格插入并在提交时检查。因此，您的所有表格都将得到保护。

CSRF令牌的存在和有效性用于检查呼叫posted方法时发布的表格是否已发布（它在handle内部使用）

如果您在form中指定name属性，则该特定表单的CSRF令牌将有所不同，如果同一页面上有多个表单，则可以实现Formidable的差异。

语言

可以使用setLanguage()设置错误的语言： 

 <?php

// Will set the language to french for errors
$ form -> setLanguage ( new Gregwar \\ Formidable \\ Language \\ French );

检查您的语言是否在Language目录中支持，请随时参与！

来源

您可以使用采购系统动态填充select ，一个multiradio或多multicheckbox ： 

 < input type =\" multicheckbox \" name =\" colours \" source =\" colours \" />

然后用source填充它： 

 <?php
$ form -> source ( \' colours \' , array ( \' red \' , \' yellow \' , \' blue \' ));

这将由一些复选框渲染。

您可以以select方式这样做： 

 < select name =\" colour \" >
    < options source =\" colours \" />
    < option value =\" other \" > Other </ option >
</ select >

然后用相同的方法来源

从字符串创建表单

您可以从文件或字符串创建表单，将自动检测到：

Formidable\\Form(\'<form method=\”post\”>
<select name=\”colour\”>
<option value=\”blue\”>Blue</option>
<option selected value=\”red\”>Red</option>
<option value=\”green\”>Green</option>
</select>
</form>\’);

echo $form->getValue(\’colour\’) . \”\\n\”;
// red

// Sets the color to blue
$form->setValue(\’colour\’, \’blue\’);

echo $form;
/* Will display:
<form method=\”post\”>
<select name=\”colour\” >
<option selected=\”selected\” value=\”blue\”>Blue</option>
<option value=\”red\”>Red</option>
<option value=\”green\”>Green</option>
</select>
<input type=\”hidden\” name=\”posted_token\” value=\”d293dc38017381b6086ff1a856c1e8fe43738c60\” />
</form>
*/\”>

 <?php

$ form = new Gregwar \\ Formidable \\ Form ( \' <form method=\"post\">
    <select name=\"colour\">
        <option value=\"blue\">Blue</option>
        <option selected value=\"red\">Red</option>
        <option value=\"green\">Green</option>
    </select>
    </form> \' );

echo $ form -> getValue ( \' colour \' ) . \"\\n\" ;
// red

// Sets the color to blue
$ form -> setValue ( \' colour \' , \' blue \' );

echo $ form ;
/* Will display:
<form method=\"post\">
    <select name=\"colour\" >
        <option selected=\"selected\" value=\"blue\">Blue</option>
        <option value=\"red\">Red</option>
        <option value=\"green\">Green</option>
    </select>
    <input type=\"hidden\" name=\"posted_token\" value=\"d293dc38017381b6086ff1a856c1e8fe43738c60\" />
</form>
*/

映射

您也可以使用mapping属性来填充表单或在数组或对象中获取表单数据，例如：

Formidable\\Form(\'<form method=\”post\”>
<input type=\”text\” name=\”name\” mapping=\”name\” />
</form>\’);

$form->setData($person);

echo $form;
/*
Will output something like:

<form method=\”post\”>
<input required=\”required\” type=\”text\” name=\”name\” value=\”Jack\” />
<input type=\”hidden\” name=\”posted_token\” value=\”aa27f437cc6127c244db14361fd614af51c79aac\” />
</form>
*/\”>

 <?php

class Person
{
    protected $ name ;
    public function getName () { return $ this -> name ; }
    public function setName ( $ name ) {
        $ this -> name = $ name ;
    }
}

$ person = new Person ;
$ person -> setName ( \' Jack \' );

$ form = new Gregwar \\ Formidable \\ Form ( \' <form method=\"post\">
    <input type=\"text\" name=\"name\" mapping=\"name\" />
    </form> \' );

$ form -> setData ( $ person );

echo $ form ;
/*
Will output something like:

<form method=\"post\">
    <input required=\"required\" type=\"text\" name=\"name\" value=\"Jack\" />
    <input type=\"hidden\" name=\"posted_token\" value=\"aa27f437cc6127c244db14361fd614af51c79aac\" />
</form>
*/

请注意，该映射使用Symfony PropertyAccessor，然后可以使用上面示例中的访问者来填充属性。

您可以使用：

  • getData($entity = array()) ：填充和返回实体，带有数据填充的数据
  • setData($entity) ：用实体属性填充表单

创建多个子形式

您可以使用<multiple>标签将多个子形式添加到页面上： 

 < form method =\" post \" >
    Film name: < input type =\" text \" name =\" film_name \" mapping =\" name \" />

    < h2 > Actors </ h2 >
    < multiple name =\" actors \" mapping =\" actors \" >
        First name: < input name =\" first_name \" mapping =\" firstName \" /> < br />
        Last name: < input name =\" last_name \" mapping =\" lastName \" /> < br />
    </ multiple >
    < input type =\" submit \" />
</ form >

这样， <multiple>可以完全像一个字段一样使用，但它将包含一系列元素。

某些JS将在页面中注入，并允许您添加/删除一些元素。

您可以使用min-entries和max-entries约束来设置倍数中条目数的限制。

如果您指定min-entries和max-entries的相同值，或指定entries的值（实际上是这样做的别名），则将osr输入的数量固定，不需要JavaScript。

将动态数据添加到表单中

在某些情况下，您需要将自定义数据添加到表单中，有两种方法可以做到这一点。

第一种方法：使用占位符

{{ something }}语法允许您简单地从代码注入数据，例如：

Formidable\\Form(\'<form method=\”post\”>
Hello {{ name }}!
</form>\’);

$form->setPlaceholder(\’name\’, \’Bob\’);

echo $form;\”>

 <?php

$ form = new Gregwar \\ Formidable \\ Form ( \' <form method=\"post\">
    Hello {{ name }}!
    </form> \' );

$ form -> setPlaceholder ( \' name \' , \' Bob \' );

echo $ form ;

在上面的示例中， {{ name }}将呈现为Bob 。

请注意，无论如何都可以使用<form>和输入标签中的占位符：

Formidable\\Form(\'<form method=\”post\”>
<span style=\”color:{{ color }}\”>Hello</span>
</form>\’);

$form->setPlaceholder(\’color\’, \’red\’);

echo $form;\”>

 <?php

$ form = new Gregwar \\ Formidable \\ Form ( \' <form method=\"post\">
    <span style=\"color:{{ color }}\">Hello</span>
    </form> \' );

$ form -> setPlaceholder ( \' color \' , \' red \' );

echo $ form ;

第二种方法：使用PHP表格

您也可以使用PHP（例如模板）编写表单： 

<form>
    <?php echo $ label ; ?> : <input type=\"text\" name=\"name\" />
    <input type=\"submit\" />
</form>

然后实现您的表单将模板变量作为第二个参数： 

 <?php

$ form = new Gregwar \\ Formidable \\ Form ( \' the-above-form.php \' , array ( \' label \' => \' Your name \' ));

$label将使用PHP解释。

缓存

出于表演原因，您可能需要缓存解析的表格。

为此，只需将true传递为构造函数的第三个论点：

Formidable\\Form(\’form.html\’, null, true);
\”>

 <?php

/**
 * Parsed data for the form will be serialized and stored in a cache file,
 * if you use this form often, this will offer you better performances.
 */
$ form = new Gregwar \\ Formidable \\ Form ( \' form.html \' , null , true );

这将使用Gregwar/Cache系统，您需要获得此存储库的作曲家依赖性或手动安装。默认情况下，缓存文件将在运行脚本的位置中写入cache目录中。

尝试在examples/目录中运行performances.php脚本，这将为您提供缓存性能增益的示例。

您还可以将Gregwar\\Cache\\Cache的实例作为第三个参数，该参数将允许您设置高速缓存目录。

执照

Gregwar\\ Formidable属于MIT许可，请查看LICENSE文件以获取更多信息。

历史

v2.0.0最终支持PHP <5.6

v2.1.0删除验证库库的硬依赖

下载源码

通过命令行克隆项目:

git clone https://github.com/Gregwar/Formidable.git

收藏 (0) 打赏

感谢您的支持，我会继续努力的!

打开微信/支付宝扫一扫，即可进行扫码打赏哦，分享从这里开始，精彩与您同在
点赞 (0)

申明：本文由第三方发布，内容仅代表作者观点，与本网站无关。对本文以及其中全部或者部分内容的真实性、完整性、及时性本站不作任何保证或承诺，请读者仅作参考，并请自行核实相关内容。本网发布或转载文章出于传递更多信息之目的，并不意味着赞同其观点或证实其描述，也不代表本网对其真实性负责。

左子网 开发教程 Formidable https://www.zuozi.net/31796.html

tokio fastcgi
上一篇： tokio fastcgi
grpc fastcgi proxy
下一篇： grpc fastcgi proxy
常见问题

发货方式是什么？

  • 1、自动：拍下后，点击（下载）链接即可下载；2、手动：拍下后，联系卖家发放即可或者联系官方找开发者发货。
查看详情

交易周期是多久呢？

  • 1、源码默认交易周期：手动发货商品为1-3天，并且用户付款金额将会进入平台担保直到交易完成或者3-7天即可发放，如遇纠纷无限期延长收款金额直至纠纷解决或者退款！；
查看详情

能退款么？

  • 1、描述：源码描述(含标题)与实际源码不一致的（例：货不对板）； 2、演示：有演示站时，与实际源码小于95%一致的（但描述中有”不保证完全一样、有变化的可能性”类似显著声明的除外）； 3、发货：不发货可无理由退款； 4、安装：免费提供安装服务的源码但卖家不履行的； 5、收费：价格虚标，额外收取其他费用的（但描述中有显著声明或双方交易前有商定的除外）； 6、其他：如质量方面的硬性常规问题BUG等。 注：经核实符合上述任一，均支持退款，但卖家予以积极解决问题则除外。
查看详情

注意事项

  • 1、左子会对双方交易的过程及交易商品的快照进行永久存档，以确保交易的真实、有效、安全！ 2、左子无法对如“永久包更新”、“永久技术支持”等类似交易之后的商家承诺做担保，请买家自行鉴别； 3、在源码同时有网站演示与图片演示，且站演与图演不一致时，默认按图演作为纠纷评判依据（特别声明或有商定除外）； 4、在没有”无任何正当退款依据”的前提下，商品写有”一旦售出，概不支持退款”等类似的声明，视为无效声明； 5、在未拍下前，双方在QQ上所商定的交易内容，亦可成为纠纷评判依据（商定与描述冲突时，商定为准）； 6、因聊天记录可作为纠纷评判依据，故双方联系时，只与对方在左子上所留的QQ、手机号沟通，以防对方不承认自我承诺。 7、虽然交易产生纠纷的几率很小，但一定要保留如聊天记录、手机短信等这样的重要信息，以防产生纠纷时便于左子介入快速处理。
查看详情

相关文章

猜你喜欢
发表评论
暂无评论
官方客服团队

为您解决烦忧 - 24小时在线 专业服务

联系官方团队 在线提交工单
TA的动态
左子网

分享最新WordPress教程共同学习，共同进步，共同成长！

QQ交流群
左子网

QQ交流群

您的支持，是我们最大的动力！ https://qm.qq.com/q/iR7Nj0TrOg
热门文章
热门标签
随机推荐
热门评论
终身VIP会员限时钜惠
首页 源码 菜单 案例 我的