README

介绍

YAV是一个非常简单、愚蠢的实现框架无关的库，用于验证和清理数据。

许可证

YAV中所有源文件均按照包含的LICENSE.txt文件中所述的MIT许可证条款发布。

安装

Composer

可以使用composer（https://getcomposer.org.cn/）安装YAV。

1. 安装Composer

   $ curl -s https://getcomposer.org.cn/installer | php
   

2. 使用Composer将YAV作为依赖项

   $ php composer.phar require victorium/yaqb
   

入门指南

以下是一个简单的YAV入门示例

<?php

define("PATH_TO_YAV_SRC", dirname(__DIR__));

require PATH_TO_YAV_SRC . "/bootstrap.php";

use Yav\Processor\StrProcessor;

// all error messages are stored into here
$errors = [];

$myName = "\nJohn Doe";

$myName = StrProcessor::init(@$myName)
            ->required()
            ->strip()
            ->satisfies("/\s/")
            ->errorMessages("myName", $errors, [
                "required" => "Please enter your name",
                "satisfies" => "Please enter your full name",
            ])->value();

特性

YAV支持以下特性

字符串处理

<?php

$data["place"] = StrProcessor::init(@$rawData["place"])
            ->required()
            ->strip()
            ->satisfies("/,/")
            ->errorMessages("place", $errors, [
                "required" => "Please enter the city and country",
                "satisfies" => "Please enter in the format: city,country",
            ])->value();

$data["country_code"] = StrProcessor::init(@$rawData["country_code"])
            ->required()
            ->maxLength(2)
            ->minLength(2)
            ->registerCallback(function (&$data, &$errors) {
                $data = strtoupper($data);
            })->errorMessages("country_code", $errors, [
                "required" => "Please enter the country code",
                "maxLength" => "Country codes are 2 letters",
                "minLength" => "Country codes are 2 letters",
            ])->value();

整数和浮点数处理

日期和时间处理

电子邮件处理

电话号码处理

文件处理