Formidable 使用与技术文档

1. 安装指南

Formidable 是一个处理表单的 PHP 库，可以通过以下方式安装：

• 通过 Composer 安装：

{
    "require": {
        "gregwar/formidable": "dev-master"
    }
}

• 通过克隆仓库：

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

• 下载压缩包：

• 点击 这里 下载 .zip 格式

• 点击 这里 下载 .tar.gz 格式

2. 使用说明

步骤 1：编写 HTML 表单

首先，需要以 HTML 格式编写你的代码，例如：

<!-- forms/example.html -->
<form method="post">
    输入你的名字： 
    <input type="text" name="name" /><br />
    <input type="submit" />
</form>

步骤 2：将表单传递给 Formidable

在 PHP 代码中，将你的表单传递给 Formidable：

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

$form = new Gregwar\Formidable\Form('forms/example.html');

$form->handle(function() {
    echo "表单验证通过！";
}, function($errors) {
    echo "错误：<br/>";
    foreach ($errors as $error) {
        echo "$error<br />";
    }
});

echo $form;

步骤 3：享受魔法

然后可以使用 Formidable API 来操作表单：

<?php

// 设置字段值
$form->name = "Bob";

// 获取字段值
$name = $form->name;

// 为字段添加约束
$form->addConstraint('name', function($value) {
    if (strlen($value) < 10) {
        return '你的名字至少应该有10个字符！';
    }
});

// 为整个表单添加约束
$form->addConstraint(function($form) {
    if ($form->getValue('pass1') != $form->getValue('pass2')) {
        return '密码不一致';
    }
});

3. 项目 API 使用文档

可以在 $form 对象上调用以下方法：

• posted(): 如果表单已提交，则返回 true
• check(): 检查表单，并返回有效性错误数组
• handle($callback, $errorCallback)，这个快捷方法调用 posted 和 check()，如果表单有效，则调用 $callback，否则调用 $errorCallback
• 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(): 获取所有字段的值

4. 项目安装方式

Formidable 项目可以通过多种方式安装，具体如下：

• 通过 Composer：

composer require gregwar/formidable dev-master

• 通过 Git 克隆：

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

• 通过下载压缩包：

  • 点击下载 .zip 格式文件
  • 点击下载 .tar.gz 格式文件

以上就是关于 Formidable 的技术文档，详细介绍了安装指南、使用说明、API 使用文档和安装方式，可以帮助用户更好地了解和使用这个 PHP 库来处理表单。