README

这个库的设计很差，其存在的理由值得怀疑。大多数情况下，你最好在自己的项目中创建专门的接口。

DataValues Interfaces 是一个小的 PHP 库，定义了解析器、格式化和验证器的接口集合。它是 DataValues 库集合的一部分。

在 Packagist 上：

安装

要在项目中使用此库，只需将 data-values/interfaces 依赖项添加到项目的 composer.json 文件中。以下是一个仅定义对 Interfaces 1.x 依赖的最小示例 composer.json 文件。

{
    "require": {
        "data-values/interfaces": "^1.0"
    }
}

测试

此库附带一套 PHPUnit 测试，涵盖所有非平凡代码。您可以使用位于根目录中的 PHPUnit 配置文件运行这些测试。这些测试也可以通过 GitHub Actions 运行。

发行说明

1.1.0 (开发版)

• 引入了 ParserOptions::withDefaultOption() 和 FormatterOptions::withDefaultOption()，它们返回应用默认值后的选项副本；废弃了修改选项的 defaultOption() 方法。

1.0.0 (2021-01-20)

• 将所需的最小 PHP 版本从 5.5.9 更新到 7.2
• 移除了 ValueFormatterBase
• 移除了 ValueFormatterTestBase
• 移除了 ValueValidator::setOptions
• 移除了 ValueValidatorObject
• 移除了 DATAVALUES_INTERFACES_VERSION 常量
• ValueValidators\Result 现在是最终的
• ValueValidators\Error 的属性现在是私有的，而不是受保护的

0.2.5 (2017-08-09)

• 移除了 MediaWiki 扩展信用注册

0.2.4 (2017-08-02)

• 修复了 ValueFormatterTestBase 不能通过 Composer 安装的问题。

0.2.3 (2017-08-02)

• 将所需的最小 PHP 版本从 5.3 更新到 5.5.9。
• 对代码文档进行了微小修复。
• 添加了 PHPCS 支持。

0.2.2 (2016-07-15)

• 修复了 ValueFormatterTestBase 不进行严格的字符串比较的问题。

0.2.1 (2016-01-13)

• 修复了在使用此组件与 HHVM 1.11.0 时的问题（见 #21）。

0.2.0 (2015-08-11)

• 废弃了 ErrorObject，请使用 Error 代替。
• 废弃了 ResultObject，请使用 Result 代替。
• 废弃了 DataValuesInterfaces_VERSION 常量，请使用 DATAVALUES_INTERFACES_VERSION 代替。
• 废弃了 ValueFormatterTestBase::getFormatterClass
• 使 ValueFormatterTestBase::getInstance 抽象
• ValueFormatterTestBase::getInstance 中的选项现在是可选的

0.1.5 (2015-02-14)

• ValueFormatterBase 构造函数中的选项现在是可选的
• MediaWiki 扩展注册现在包括许可协议

0.1.4 (2014-04-14)

• 向 ValueParsers\ParseException 添加了 rawValue 和 expectedFormat 参数

0.1.3 (2014-03-31)

• 添加了 ValueFormatters\FormattingException

0.1.2 (2013-11-22)

• 改进了自动加载代码
• 修复了 MediaWiki 信用中的链接
• 入口点名称从DataValuesInterfaces.php更改为Interfaces.php

0.1.0 (2013-11-16)

初始发布包含以下功能

• ValueFormatters\ValueFormatter 接口
• ValueParsers\ValueParser 接口
• ValueValidators\ValueValidator 接口

链接

• 在Packagist上的DataValues 接口