ptrofimov/matchmaker

超新鲜的PHP匹配函数

1.0 2014-06-28 08:54 UTC

This package is not auto-updated.

Last update: 2024-09-10 02:17:46 UTC


README

PHP函数,帮助您验证复杂嵌套PHP数组的结构。

$books = [
    [
        'type' => 'book',
        'title' => 'Geography book',
        'chapters' => [
            'eu' => ['title' => 'Europe', 'interesting' => true],
            'as' => ['title' => 'America', 'interesting' => false]
        ]
    ],
    [
        'type' => 'book',
        'title' => 'Foreign languages book',
        'chapters' => [
            'de' => ['title' => 'Deutsch']
        ]
    ]
];

$pattern = [
    '*' => [
        'type' => 'book',
        'title' => ':string contains(book)',
        'chapters' => [
            ':string length(2) {1,3}' => [
                'title' => ':string',
                'interesting?' => ':bool',
            ]
        ]
    ]
];

matchmaker\matches($books, $pattern); // true

它可以用来检查来自不同来源(JSON、XML、Post Data)的标量值、对象或数组。

匹配规则

匹配规则是字符串,以“:”开头。您可以使用空格连接多个匹配器。匹配器可以是任何可调用的(函数名或闭包)。您可以添加自己的规则或替换标准规则。

  • 通用

  • empty

  • nonempty

  • required

  • in(a, b, ...)

  • mixed

  • any

  • 类型

  • array

  • bool

  • boolean

  • callable

  • double

  • float

  • int

  • integer

  • long

  • numeric

  • number

  • object

  • real

  • resource

  • scalar

  • string

  • 数字

  • gt(n)

  • gte(n)

  • lt(n)

  • lte(n)

  • negative

  • positive

  • between(a, b)

  • 字符串

  • alnum

  • alpha

  • cntrl

  • digit

  • graph

  • lower

  • print

  • punct

  • space

  • upper

  • xdigit

  • regexp(pattern)

  • email

  • url

  • ip

  • length(n)

  • min(n)

  • max(n)

  • contains(needle)

  • starts(s)

  • ends(s)

  • json

  • date

  • 数组

  • count(n)

  • keys(key1, key2, ...)

  • 对象

  • instance(class)

  • property(name, value)

  • method(name, value)

更多详细信息请见这里

键的量词

  • ! - 一个键是必需的(默认)
  • ? - 可选键
      • 任何数量的键
  • {3} - 键的严格数量
  • {1,5} - 范围

对于匹配器(例如“:string”),默认量词是“*”

安装

  • 通过Composer为您的项目安装matchmaker
composer require ptrofimov/matchmaker:*

许可证

版权(c)2014 Petr Trofimov

MIT许可证

在此,特此授予任何获得本软件和相关文档副本(“软件”)的个人免费使用软件的权利,包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售软件副本的权利,并允许向软件提供方提供软件的个人以这样做,前提是遵守以下条件

上述版权声明和本许可声明应包含在软件的副本或主要部分中。

软件按“原样”提供,不提供任何明示或暗示的保证,包括但不限于对适销性、特定用途适用性和非侵权的保证。在任何情况下,作者或版权所有者均不对任何索赔、损害或其他责任负责,无论是否基于合同、侵权或其他原因,源自、因或与软件或软件的使用或其他交易有关。