README.verify.md · Teval/pUtils

# verify

> 数据验证
> 1. 使用exec()或run()方法返回验证结果
> 2. 支持链式调用，多个验证方法有一个不通过时，验证结果即为false

## isNull()

> 验证是否为null或空字符串，支持一个参数：
>
> input：可选参数，若传入，即表示需要将待验证的值改设为此值

```php
use pUtils\verify;

verify::isNull()::exec();       // true
verify::isNull(null)::exec();   // true
verify::isNull("")::exec();     // true

verify::isNull(false)::exec();  // false
verify::isNull(0)::exec();      // false
verify::isNull("0")::exec();    // false
verify::isNull([])::exec();     // false
```

## isNotNull()

> 验证是否不为null或空字符串（与isNull()相反）

```php
use pUtils\verify;

verify::isNotNull(false)::exec();   // true
verify::isNotNull(0)::exec();       // true
verify::isNotNull("0")::exec();     // true
verify::isNotNull([])::exec();      // true

verify::isNotNull()::exec();        // false
verify::isNotNull(null)::exec();    // false
verify::isNotNull("")::exec();      // false
```

## isEmpty()

> 验证是否为null或空字符串或空数组或空对象，支持一个参数：
>
> input：可选参数，若传入，即表示需要将待验证的值改设为此值

```php
use pUtils\verify;

verify::isEmpty()::exec();                  // true
verify::isEmpty(null)::exec();              // true
verify::isEmpty("")::exec();                // true
verify::isEmpty([])::exec();                // true
verify::isEmpty(new stdClass())::exec();    // true

verify::isEmpty(false)::exec();             // false
verify::isEmpty(0)::exec();                 // false
verify::isEmpty("0")::exec();               // false
```

## isDate()

> 验证是否为日期(时间)格式，支持两个参数：
>
> 1. format：指定日期(时间)格式，若为数组，则多个格式满足其一即可，默认为：["Y-m-d", "Y-m-d H:i", "Y-m-d H:i:s", "Y/m/d", "Y/m/d H:i", "Y/m/d H:i:s", "H:i", "H:i:s"]
> 2. input：可选参数，若传入，即表示需要将待验证的值改设为此值

```php
use pUtils\verify;

verify::isDate()::exec();                       // false
verify::isDate(null, null)::exec();             // false
verify::isDate(null, "")::exec();               // false
verify::isDate(null, [])::exec();               // false
verify::isDate(null, new stdClass())::exec();   // false
verify::isDate(null, "2021-02-30")::exec();     // false

// 链式调用时
verify::isNotNull()::isDate()::exec();                  // false
verify::isNotNull(null)::isDate()::exec();              // false
verify::isNotNull("")::isDate()::exec();                // false
verify::isNotNull([])::isDate()::exec();                // false
verify::isNotNull(new stdClass())::isDate()::exec();    // false
verify::isNotNull("2021-02-30")::isDate()::exec();      // false
    
verify::isNotNull("2021-02-28")::isDate()::exec();           // true
verify::isNotNull("20:30")::isDate()::exec();                // true
verify::isNotNull("20:30:02")::isDate()::exec();             // true
verify::isNotNull("2021/02/28 20:30")::isDate()::exec();     // true
verify::isNotNull("2021/02/28 20:30:15")::isDate()::exec();  // true

// 自定义日期格式
verify::isDate("Y-m-d", "2021-02-28")::exec();                  // true
verify::isDate("H:i", "20:30")::exec();                         // true
verify::isDate(["H:i", "H:i:s"], "20:30:02")::exec();           // true
verify::isDate("Y/m/d H:i", "2021/02/28 20:30")::exec();        // true
verify::isDate(["Y/m/d H:i:s"], "2021/02/28 20:30:15")::exec(); // true
```

## isInt()

> 验证是否为整数，支持一个参数：
>
> input：可选参数，若传入，即表示需要将待验证的值改设为此值

```php
use pUtils\verify;

verify::isInt()::exec();                // false
verify::isInt(null)::exec();            // false
verify::isInt("")::exec();              // false
verify::isInt(0.1)::exec();             // false
verify::isInt([])::exec();              // false
verify::isInt(new stdClass())::exec();  // false

verify::isInt(0)::exec();               // true
verify::isInt(1)::exec();               // true
verify::isInt("2")::exec();             // true
```

## isFloat()

> 验证是否为浮点数，支持一个参数：
>
> input：可选参数，若传入，即表示需要将待验证的值改设为此值

```php
use pUtils\verify;

verify::isFloat()::exec();                  // false
verify::isFloat(null)::exec();              // false
verify::isFloat(false)::exec();             // false
verify::isFloat("")::exec();                // false
verify::isFloat(1)::exec();                 // false
verify::isFloat([])::exec();                // false
verify::isFloat(new stdClass())::exec();    // false

verify::isFloat(0.1)::exec();               // true
verify::isFloat(-1.5)::exec();              // true
verify::isFloat("+2.1")::exec();            // true
```

## isNumber()

> 验证是否为数值（整数或浮点数），用法类似isInt()、isFloat()，支持一个参数：
>
> input：可选参数，若传入，即表示需要将待验证的值改设为此值

## isMobile()

> 验证是否为手机号(判断依据为满足正则：/^1[345789]\d{9}$/)，支持一个参数：
>
> input：可选参数，若传入，即表示需要将待验证的值改设为此值

```php
use pUtils\verify;

verify::isMobile()::exec();                 // false
verify::isMobile(null)::exec();             // false
verify::isMobile(false)::exec();            // false
verify::isMobile("")::exec();               // false
verify::isMobile(1)::exec();                // false
verify::isMobile([])::exec();               // false
verify::isMobile(new stdClass())::exec();   // false
verify::isMobile("a1351355135")::exec();    // false

verify::isMobile("13513551355")::exec();    // true
verify::isMobile("18686868686")::exec();    // true
```

## isUrl()

> 验证是否为Url链接，用法类似isMobile()，判断依据为：utils::isUrl()

## isMac()

> 验证是否为Mac地址，用法类似isMobile()，判断依据为：utils::isMac()

## isIp()

> 验证是否为Ip地址，用法类似isMobile()，判断依据为：utils::isIp()

## len()

> 验证是否字符长度（或数值大小）不超过指定值，支持两个参数：
>
> input：可选参数，若传入，即表示需要将待验证的值改设为此值
>
> maxLen：可选参数，大于0时生效

```php
use pUtils\verify;

verify::len("abcd", 4)::exec(); // true
verify::len("abcd", 3)::exec(); // false
verify::len(100, 100)::exec();  // true
verify::len(100, 99)::exec();   // false
```

## between()

> 验证是否在指定的起止范围内（包括边界，支持数值和日期/时间），支持三个参数：
>
> start：起始值
>
> end：截止值
>
> input：可选参数，若传入，即表示需要将待验证的值改设为此值

```php
// 数值
use pUtils\verify;

verify::between(5, 10, 6)::exec();      // true
verify::between(10, 6, 8)::exec();      // true
verify::between("10", 6, "8")::exec();  // true

// 时间
verify::between("20:30", "16:24", "19:45")::exec();   // true

// 日期
verify::between("2021-02-28", "2021-03-28", "2021-03-05")::exec();   // true
verify::between("2021-03-28", "2021-02-28", "2021-03-05")::exec();   // true
verify::between("2021-02-28", "2021-03-28", "2021-05-05")::exec();   // false

// 日期时间
verify::between("2021-02-28 20:30", "2021-03-28 16:24", "2021-03-15 19:45")::exec();   // true
```

## less()

> 验证是否小于某值（支持数值和日期/时间），支持两个参数：
>
> arg：界限值
>
> input：可选参数，若传入，即表示需要将待验证的值改设为此值

```php
use pUtils\verify;

verify::less(5, 4)::exec();                                     // true
verify::isInt(10)::less(10)::exec();                            // false
verify::isInt("10")::less(11)::exec();                          // true
verify::isNotNull("2021-02-28")::less("2021-03-01")::exec();    // true
```

## more()

> 验证是否大于某值（支持数值和日期/时间），用法类似less()，支持两个参数：
>
> arg：界限值
>
> input：可选参数，若传入，即表示需要将待验证的值改设为此值

## least()

> 验证是否至少为某值，（即>=某值，支持数值和日期/时间），用法类似less()，支持两个参数：
>
> arg：界限值
>
> input：可选参数，若传入，即表示需要将待验证的值改设为此值

## most()

> 验证是否最多为某值，（即<=某值，支持数值和日期/时间），用法类似less()，支持两个参数：
>
> arg：界限值
>
> input：可选参数，若传入，即表示需要将待验证的值改设为此值

Teval/pUtils

简介

发行版 (1)

贡献者

近期动态

Teval/pUtils .gitee-modal { width: 500px !important; }

简介

发行版 (1)

贡献者

近期动态

搜索帮助

Teval/pUtils