首页>PHP源码>其他类别
下载

verum php

verum php是 PHP 的服务器端验证库，可让您轻松验证数组（具有文件支持）。它带有自定义错误消息、规则、内置翻译和零依赖性。

PHP 服务器端验证库

  • 验证数组（带文件支持）
  • 自定义错误消息
  • 自定义规则
  • 内置翻译
  • 零依赖

目录

  1. 入门
  2. 用法
  3. 自定义验证
  4. 可用规则
  5. 贡献
  6. 问题
  7. 执照

入门

安装

使用 Composer 安装verum php 

composer require sandromiguel/verum-php

用法

简单使用示例

验证简单的注册表（姓名、电子邮件和年龄） 

 use Verum  Validator ;

$ rules = [
    ' name ' => [
        ' rules ' => [
            ' required ' ,
        ],
    ],
    ' email ' => [
        ' rules ' => [
            ' required ' ,
            ' email ' ,
        ],
    ],
    ' age ' => [
        ' rules ' => [
            ' numeric ' ,
        ],
    ],
];

$ validator = new Validator ( $ _POST , $ rules );

echo json_encode (
    [
        ' valid '  => $ validator -> validate (),
        ' errors ' => $ validator -> getErrors (),
    ]
);
有效表格示例

输入： 

[
    'name' => 'John Doe',
    'email' => '[email protected]',
    'age' => '20',
]

输出： 

{
    "valid" : true ,
    "errors" : []
}
无效的表单示例

输入： 

[
    'name' => '',
    'email' => 'some text',
    'age' => 'some text',
]

输出： 

{
    "valid" : false ,
    "errors" : {
        "name" : {
            "label" : null ,
            "rules" : {
                "required" : " This field is required. "
            }
        },
        "email" : {
            "label" : null ,
            "rules" : {
                "email" : " This field must be a valid email address. "
            }
        },
        "age" : {
            "label" : null ,
            "rules" : {
                "numeric" : " This field must be numeric. "
            }
        }
    }
}

使用RuleEnum类

您可以使用RuleEnum类来访问所有规则名称。 

 use Verum  Validator ;
use Verum  Enum  RuleEnum ;

$ rules = [
    ' name ' => [
        ' rules ' => [
            RuleEnum:: REQUIRED ,
        ],
    ],
    ...
];

指定字段标签（命名输入） 

 $ rules = [
    ' name ' => [
        ' label ' => ' Name ' ,
        ' rules ' => [
            RuleEnum:: REQUIRED ,
        ],
    ],
    ...
];

输出： 

{
    ...
    "errors" : {
        "name" : {
            "label" : " Name " ,
            "rules" : {
                "required" : 'The "Name" field is required.'
            }
        },
        ...
    }
}

指定每种语言的字段标签

 $ rules = [
    ' name ' => [
        ' label ' => [
            ' en ' => ' Name ' ,
            ' pt-pt ' => ' Nome ' ,
        ],
        ' rules ' => [
            RuleEnum:: REQUIRED ,
        ],
    ],
    ...
];

输出（点-点）： 

{
    ...
    "errors" : {
        "name" : {
            "label" : " Nome " ,
            "rules" : {
                "required" : 'O campo "Nome" é obrigatório.'
            }
        },
        ...
    }
}

指定消息语言

您可以使用一些内置翻译：

  • 'en' -> 英语（默认）
  • 'nl-nl' -> 荷兰语
  • 'pt-pt' -> 葡萄牙语-葡萄牙
  • 'pt-br' -> 葡萄牙语-巴西
 $ validator = new Validator ( $ _POST , $ rules , ' pt-pt ' );

使用LangEnum类指定消息语言

 use Verum  Validator ;
use Verum  Enum  LangEnum ;

. . .

$ validator = new Validator ( $ _POST , $ rules , LangEnum:: PT_PT );

指定自定义错误消息

  • 对于覆盖默认错误消息很有用。
  • 对于本地化很有用。 
 . . .
$ validator = new Validator ( $ _POST , $ rules );
$ validator -> addSimpleCustomMessage ( ' min_length ' , ' Min Length rule custom error message ' );
. . .

输出示例： 

{
    ...
    "errors" : {
        "name" : {
            "label" : " Name " ,
            "rules" : {
                "min_length" : " Min Length rule custom error message "
            }
        },
        ...
    }
}

使用占位符指定自定义错误消息

 . . .
$ validator = new Validator ( $ _POST , $ rules );
$ validator -> addSimpleCustomMessage ( ' min_length ' , ' Number of characters detected: {param:1}. Field name: "{param:2}". ' );
. . .

输出示例： 

{
    ...
    "errors" : {
        "name" : {
            "label" : " Name " ,
            "rules" : {
                "min_length" : 'Number of characters detected: 5. Field name: "Name".'
            }
        },
        ...
    }
}

为带标签和不带标签的字段指定自定义错误消息

 . . .
$ validator = new Validator ( $ _POST , $ rules );
$ validator -> addCustomMessage (
    ' required ' ,
    ' Custom error message with label for required rule. Label: {param:1}. ' ,
    ' Custom error message without label for required rule. '
);
. . .

输出 - 带标签的字段： 

{
    ...
    "errors" : {
        "name" : {
            "label" : " Name " ,
            "rules" : {
                "required" : 'Custom error message with label for required rule. Label: Name.'
            }
        },
        ...
    }
}

输出 - 没有标签的字段： 

{
    ...
    "errors" : {
        "name" : {
            "label" : null ,
            "rules" : {
                "required" : " Custom error message without label for required rule. "
            }
        },
        ...
    }
}

一次指定多个自定义错误消息

 . . .
$ validator = new Validator ( $ _POST , $ rules );
$ validator -> addCustomMessages (
    [
        ' min_length ' => ' Custom message for the "min_length" rule. ' ,
        ' required ' => ' Custom message for the "required" rule. ' ,
        // other messages ...
    ]
);
. . .

为带标签和不带标签的字段一次指定多个自定义错误消息

 . . .
$ validator = new Validator ( $ _POST , $ rules );
$ validator -> addCustomMessages (
    [
        ' numeric ' => [
            ' withLabel ' => ' Custom message with label for "numeric" rule. Label: {param:1}. ' ,
            ' withoutLabel ' => ' Custom message without label for "numeric" rule. ' ,
        ],
        ' min_length ' => [
            ' withLabel ' => ' Custom message with label for "min_length" rule. Label: {param:2}, value: {param:1}. ' ,
            ' withoutLabel ' => ' Custom message without label for "min_length" rule. Value: {param:1}. ' ,
        ],
        // other messages ...
    ]
);
. . .

处理多名称字段

使用verum php ，您可以更有效地处理多名称字段。这些字段包含语言标识符或其名称的其他变体。例如，如果您有title.en 、 title.pt 、 description.en和description.pt等字段，则可以使用通配符为其指定规则。 

 $ rules = [
    ' title.* ' => [
        ' rules ' => [
            RuleEnum:: REQUIRED ,
        ],
    ],
    ' description.* ' => [
        ' rules ' => [
            RuleEnum:: REQUIRED ,
            RuleEnum:: MIN_LENGTH => 10 ,
        ],
    ],
];

$ validator = new Validator ( $ _POST , $ rules );
// ...

输出示例： 

{
    "valid" : false ,
    "errors" : {
        "title.en" : {
            "label" : null ,
            "rules" : {
                "required" : " This field is required. "
            }
        },
        "title.pt" : {
            "label" : null ,
            "rules" : {
                "required" : " This field is required. "
            }
        },
        "description.en" : {
            "label" : null ,
            "rules" : {
                "required" : " This field is required. " ,
                "min_length" : " This field must be at least 10 characters long. "
            }
        },
        "description.pt" : {
            "label" : null ,
            "rules" : {
                "required" : " This field is required. " ,
                "min_length" : " This field must be at least 10 characters long. "
            }
        }
    }
}

自定义验证

您可以使用自定义验证并注入错误消息。 

 if ( $ myCustomValidationFail ) {
    $ validator -> addError (
        ' someFieldName ' ,
        ' Some field name ' ,
        [ ' no_duplicate ' => ' A user already exists with that username ' )]
    );
    // ...
}

可用规则

  1. 阿尔法
  2. 字母数字
  3. 之间
  4. 长度之间
  5. 布尔值
  6. 包含
  7. 日期
  8. 电子邮件
  9. 等于
  10. 文件最大大小
  11. 文件mime_类型
  12. 浮点数
  13. 图像最大高度
  14. 图像最大宽度
  15. 图像最小高度
  16. 图像最小宽度
  17. 整数
  18. ip
  19. ipv4
  20. ipv6
  21. 最大限度
  22. 最大长度
  23. 分钟
  24. 最小长度
  25. 数字
  26. 正则表达式
  27. 必需的
  28. 蛞蝓
  29. 网址

阿尔法

检查该值是否仅包含字母字符。 

 $ rules = [
    ' nickname ' => [
        ' label ' => ' Nickname ' ,
        ' rules ' => [
            RuleEnum:: ALPHA ,
        ],
    ],
];
价值阿尔法阿尔法 + 必需
null ✔️
'' ✔️
'0'
0
false
[]
-1
1
true
'text' ✔️ ✔️
'text with spaces'

字母数字

检查该值是否仅包含字母数字字符。 

 $ rules = [
    ' nickname ' => [
        ' label ' => ' Nickname ' ,
        ' rules ' => [
            RuleEnum:: ALPHA_NUMERIC ,
        ],
    ],
];
价值字母数字字母数字 + 必需
null ✔️
'' ✔️
'0' ✔️ ✔️
0 ✔️ ✔️
false
[]
-1
1 ✔️ ✔️
true
'text' ✔️ ✔️
'text with spaces'

之间

检查该值是否在两个值之间。 

 $ rules = [
    ' age ' => [
        ' label ' => ' Age ' ,
        ' rules ' => [
            RuleEnum:: BETWEEN => [ 12 , 29 ],
        ],
    ],
];
价值[1, 10] 之间介于 [1, 10] + 必需之间
null ✔️
'' ✔️
'0'
0
false
[]
-1
1 ✔️ ✔️
true
'some text'

长度之间

检查值的字符数是否在最小值和最大值之间。 

 $ rules = [
    ' nickname ' => [
        ' label ' => ' Nickname ' ,
        ' rules ' => [
            RuleEnum:: BETWEEN_LENGTH => [ 3 , 15 ],
        ],
    ],
];
价值长度之间 [5,25] Between_length [5,25] + 必需
null ✔️
'' ✔️
'0'
0
false
[]
-1
1
12345 ✔️ ✔️
true
'text'
'text with 23 characters' ✔️ ✔️

布尔值

检查该值是否为布尔值。对于 1/0、“1”/“0”、“开”/“关”、“是”/“否”、真/假返回 true。 

 $ rules = [
    ' light ' => [
        ' label ' => ' Light ' ,
        ' rules ' => [
            RuleEnum:: BOOLEAN_VALUE ,
        ],
    ],
];
价值布尔值布尔值 + 必需
null ✔️
'' ✔️
'0' ✔️ ✔️
0 ✔️ ✔️
false ✔️ ✔️
[]
-1
'1' ✔️ ✔️
1 ✔️ ✔️
true ✔️ ✔️
'text'
'on' ✔️ ✔️
'off' ✔️ ✔️
'yes' ✔️ ✔️
'no' ✔️ ✔️

包含

检查该值是否在数组中。 

 $ rules = [
    ' priority ' => [
        ' label ' => ' Priority ' ,
        ' rules ' => [
            RuleEnum:: CONTAINS => [ ' low ' , ' high ' ],
        ],
    ],
];
价值包含['低','高']包含 ['low','high'] + 必需
null ✔️
'' ✔️
'0'
0
false
[]
-1
1
true
'text'
'low' ✔️ ✔️
'high' ✔️ ✔️

日期

检查该值是否是有效日期 (Ymd) 还是自定义格式。

默认格式（年） 

 $ rules = [
    ' dob ' => [
        ' label ' => ' Date of birth ' ,
        ' rules ' => [
            RuleEnum:: DATE ,
        ],
    ],
];

自定义格式 (egdmY) 

 $ rules = [
    ' dob ' => [
        ' label ' => ' Date of birth ' ,
        ' rules ' => [
            RuleEnum:: DATE => [ ' d.m.Y ' ],
        ],
    ],
];
价值日期 [年]日期 [Ymd] + 必填
null ✔️
'' ✔️
'0'
0
false
[]
-1
1
true
'text'
'2020-09-30' ✔️ ✔️

电子邮件

检查该值是否具有有效的电子邮件格式。 

 $ rules = [
    ' email ' => [
        ' label ' => ' Email ' ,
        ' rules ' => [
            RuleEnum:: EMAIL ,
        ],
    ],
];
价值电子邮件电子邮件 + 必填项
null ✔️
'' ✔️
'0'
0
false
[]
-1
1
true
'text'
'[email protected]' ✔️ ✔️

等于

检查该值是否等于另一个值。 

 $ rules = [
    ' repeat_password ' => [
        ' label ' => ' Repeat Password ' ,
        ' rules ' => [
            RuleEnum:: EQUALS => [ ' password ' ],
        ],
    ],
];

与'text'比较

价值等于等于 + 必需
null ✔️
'' ✔️
'0'
0
false
[]
-1
1
true
'text' ✔️ ✔️
'another text'

文件最大大小

检查文件大小是否未超过给定值。

输入一个以字节为单位的值。 

 $ rules = [
    ' profile_photo ' => [
        ' label ' => ' Profile Photo ' ,
        ' rules ' => [
            RuleEnum:: FILE_MAX_SIZE => [ 102400 ],
        ],
    ],
];

与102400字节的比较

价值文件最大大小文件最大大小 + 必需
null ✔️
50000 ✔️ ✔️
150000

文件mime_类型

检查文件类型是否允许。 

 $ rules = [
    ' profile_photo ' => [
        ' label ' => ' Profile Photo ' ,
        ' rules ' => [
            RuleEnum:: FILE_MIME_TYPE => [ ' image/png ' , ' image/jpeg ' ],
        ],
    ],
];
价值文件mime类型file_mime_type + 必需
null ✔️
image/png ✔️ ✔️
text/plain

浮点数

检查该值是否为浮点数。 

 $ rules = [
    ' price ' => [
        ' label ' => ' Price ' ,
        ' rules ' => [
            RuleEnum:: FLOAT_NUMBER ,
        ],
    ],
];
价值浮点数float_number + 必需
null ✔️
'' ✔️
'0'
0
false
[]
-1
1
12345
123.45 ✔️ ✔️
true
'text'
'text with spaces'

图像最大高度

检查图像高度是否超过给定值。 

 $ rules = [
    ' profile_photo ' => [
        ' label ' => ' Profile Photo ' ,
        ' rules ' => [
            RuleEnum:: IMAGE_MAX_HEIGHT => [ 600 ],
        ],
    ],
];
价值图像最大高度image_max_height + 必需
null ✔️
500像素✔️ ✔️
1000像素

图像最大宽度

检查图像宽度是否不超过给定值。 

 $ rules = [
    ' profile_photo ' => [
        ' label ' => ' Profile Photo ' ,
        ' rules ' => [
            RuleEnum:: IMAGE_MAX_WIDTH => [ 1000 ],
        ],
    ],
];
价值图像最大宽度image_max_width + 必需
null ✔️
500像素✔️ ✔️
1500像素

图像最小高度

检查图像高度是否不小于给定值。 

 $ rules = [
    ' profile_photo ' => [
        ' label ' => ' Profile Photo ' ,
        ' rules ' => [
            RuleEnum:: IMAGE_MIN_HEIGHT => [ 300 ],
        ],
    ],
];
价值图像最小高度image_min_height + 必需
null ✔️
100像素
500像素✔️ ✔️

图像最小宽度

检查图像宽度是否不小于给定值。 

 $ rules = [
    ' profile_photo ' => [
        ' label ' => ' Profile Photo ' ,
        ' rules ' => [
            RuleEnum:: IMAGE_MIN_WIDTH => [ 500 ],
        ],
    ],
];
价值图像最小宽度image_min_width + 必需
null ✔️
400像素
600像素✔️ ✔️

整数

检查该值是否为整数。 

 $ rules = [
    ' distance ' => [
        ' label ' => ' Distance ' ,
        ' rules ' => [
            RuleEnum:: INTEGER ,
        ],
    ],
];
价值数字数字 + 必需
null ✔️
'' ✔️
'0'
0 ✔️ ✔️
false
[]
-1 ✔️ ✔️
1 ✔️ ✔️
true
'text'

ip

检查该值是否是有效的 IP 地址。 

 $ rules = [
    ' ip ' => [
        ' label ' => ' IP ' ,
        ' rules ' => [
            RuleEnum:: IP ,
        ],
    ],
];
价值ip ip + 必填
null ✔️
'' ✔️
'0'
0
false
[]
-1
1
true
'text'
'10.10.10.10' ✔️ ✔️
'2607:f0d0:1002:51::4' ✔️ ✔️

ipv4

检查该值是否是有效的 IPv4 地址。 

 $ rules = [
    ' ipv4 ' => [
        ' label ' => ' IPv4 ' ,
        ' rules ' => [
            RuleEnum:: IPV4 ,
        ],
    ],
];
价值ipv4 IPv4 + 必需
null ✔️
'' ✔️
'0'
0
false
[]
-1
1
true
'text'
'10.10.10.10' ✔️ ✔️
'2607:f0d0:1002:51::4'

ipv6

检查该值是否是有效的 IPv6 地址。 

 $ rules = [
    ' ipv6 ' => [
        ' label ' => ' IPv6 ' ,
        ' rules ' => [
            RuleEnum:: IPV6 ,
        ],
    ],
];
价值ipv6 IPv6 + 必需
null ✔️
'' ✔️
'0'
0
false
[]
-1
1
true
'text'
'10.10.10.10'
'2607:f0d0:1002:51::4' ✔️ ✔️

最大限度

检查该值是否不超过给定值。 

 $ rules = [
    ' people ' => [
        ' label ' => ' People ' ,
        ' rules ' => [
            RuleEnum:: MAX => [ 5 ],
        ],
    ],
];
价值最大限度最大+必需
null ✔️
'' ✔️
'0' ✔️ ✔️
0 ✔️ ✔️
false
[]
-1 ✔️ ✔️
1 ✔️ ✔️
true
'text'
12345
'12345'

最大长度

检查值的字符数是否不超过给定值。 

 $ rules = [
    ' nickname ' => [
        ' label ' => ' Nickname ' ,
        ' rules ' => [
            RuleEnum:: MAX_LENGTH => [ 2 ],
        ],
    ],
];
价值最大长度最大长度 + 必需
null ✔️
'' ✔️
'0' ✔️ ✔️
0 ✔️ ✔️
false ✔️ ✔️
[]
-1 ✔️ ✔️
1 ✔️ ✔️
true ✔️ ✔️
'text'
12345
'12345'

分钟

检查该值是否不小于给定值。 

 $ rules = [
    ' people ' => [
        ' label ' => ' People ' ,
        ' rules ' => [
            RuleEnum:: MIN => [ 2 ],
        ],
    ],
];
价值分钟分钟 + 必需
null ✔️
'' ✔️
'0'
0
false
[]
-1
1
true
'text'
12345 ✔️ ✔️
'12345' ✔️ ✔️

最小长度

检查值的字符数是否不小于给定值。 

 $ rules = [
    ' nickname ' => [
        ' label ' => ' Nickname ' ,
        ' rules ' => [
            RuleEnum:: MIN_LENGTH => [ 2 ],
        ],
    ],
];
价值最大长度最大长度 + 必需
null ✔️
''
'0'
0
false
[]
-1 ✔️ ✔️
1
true
'text' ✔️ ✔️
12345 ✔️ ✔️
'12345' ✔️ ✔️

数字

检查该值是否为数字。 

 $ rules = [
    ' age ' => [
        ' label ' => ' Age ' ,
        ' rules ' => [
            RuleEnum:: NUMERIC ,
        ],
    ],
];
价值数字数字 + 必需
null ✔️
'' ✔️
'0' ✔️ ✔️
0 ✔️ ✔️
false
[]
-1 ✔️ ✔️
1 ✔️ ✔️
true
'text'

正则表达式

检查值是否与给定的正则表达式匹配。 

 $ rules = [
    ' path ' => [
        ' label ' => ' Path ' ,
        ' rules ' => [
            RuleEnum:: REGEX => [ ' //client/[0-9a-f]+$/ ' ],
        ],
    ],
];

使用'//client/[0-9a-f]+$/'模式进行验证

价值正则表达式正则表达式 + 必需
null ✔️
'' ✔️
'0'
0
false
[]
-1
1
true
'text'
'/client/77c9e105d1f548b29958f0512967de87' ✔️ ✔️
'/client/invalid-uuid'

必需的

检查该值是否不为空。 

 $ rules = [
    ' name ' => [
        ' label ' => ' Name ' ,
        ' rules ' => [
            RuleEnum:: REQUIRED ,
        ],
    ],
];
价值必需的
null
''
'0' ✔️
0 ✔️
false ✔️
[]
-1 ✔️
1 ✔️
true ✔️
'some text' ✔️

蛞蝓

检查该值是否是有效的 Slug（例如 hello-world_123）。 

 $ rules = [
    ' slug ' => [
        ' label ' => ' Slug ' ,
        ' rules ' => [
            RuleEnum:: SLUG ,
        ],
    ],
];
价值蛞蝓slug + 必需
null ✔️
'' ✔️
'0'
0
false
[]
-1
1
true
'text' ✔️ ✔️
'text with spaces'
'hello-world_123' ✔️ ✔️

网址

检查该值是否是有效的 URL。 

 $ rules = [
    ' url ' => [
        ' label ' => ' URL ' ,
        ' rules ' => [
            RuleEnum:: URL ,
        ],
    ],
];
价值网址网址+必填项
null ✔️
'' ✔️
'0'
0
false
[]
-1
1
true
'text'
'http://www.some-domain.com' ✔️ ✔️

贡献

想做出贡献吗？欢迎所有贡献。阅读贡献指南。

问题

如果您有疑问，请发送推文给我@sandro_m_m 或提出问题。

执照

该项目已根据 MIT 许可证获得许可 - 有关详细信息，请参阅许可证文件

**~分享就是关怀~**

展开
附加信息
相关应用
为您推荐
相关资讯 全部