assegaiphp/forms

处理HTML表单提交的简单PHP库。

0.4.4 2024-03-03 09:33 UTC

This package is auto-updated.

Last update: 2024-09-03 10:29:40 UTC


README

Assegai Logo

一个用于构建高效且可扩展的服务器端应用的渐进式PHP框架。

描述

Assegai是一个用于构建高效、可扩展的PHP服务器端应用的框架。它使用现代PHP (~ PHP 8.1) 并结合了面向对象编程(OOP)和函数式编程(FP)的元素。

概述

AssegaiPHP Forms库是一个强大且灵活的工具,用于管理通过POST、PUT或PATCH请求提交的HTML表单。此库旨在简化PHP Web应用程序中处理表单数据、验证和提交的过程。它提供了一个干净直观的界面来创建、处理和验证表单,使开发者更容易构建健壮和安全的Web应用程序。

功能

  • 表单创建:使用简单直观的语法轻松以编程方式创建HTML表单。
  • 表单字段:支持各种类型的表单字段,如文本字段、复选框、单选按钮、下拉菜单等。
  • 数据绑定:自动使用模型或数组中的数据填充表单字段。
  • 验证:为表单字段定义验证规则,并轻松进行服务器端验证。
  • 错误处理:自动在对应的表单字段旁边显示验证错误。
  • CSRF保护:内置CSRF令牌生成和验证,以增强安全性。
  • 文件上传:轻松处理文件上传,并将其无缝集成到表单中。
  • 自定义:高度可定制的渲染、主题和扩展功能。
  • 兼容性:与现代化PHP应用程序兼容并遵循最佳实践。

安装

您可以使用Composer安装AssegaiPHP Forms库。

composer require assegaiphp/forms

快速入门

  1. 创建表单

    use Assegai\Forms\Form;
    
    $form = new Form('contact_form', 'POST', '/submit');
  2. 添加表单字段

    $form->addText('name', 'Name')->required();
    $form->addEmail('email', 'Email')->required()->email();
    $form->addTextarea('message', 'Message')->required();
  3. 处理表单提交

    if ($form->isSubmitted() && $form->isValid()) {
        // Process the form data
        $data = $form->getData();
        // ...
    }
  4. 渲染表单

    echo $form->render();

有关更详细的用法和自定义选项,请参阅文档

贡献

我们欢迎社区贡献!如果您想为AssegaiPHP Forms库做出贡献,请遵循我们的贡献指南

许可

AssegaiPHP Forms库是开源软件,许可协议为MIT许可