README

DataValues Common是一个小库，它基于DataValues构建，提供了DataValues、ValueParsers、ValueFormatters和ValueValidators接口的常用实现。

安装

推荐使用Composer使用此库。

要将此包作为本地、特定项目的依赖项添加到您的项目中，只需将data-values/common依赖项添加到您的项目中的composer.json文件中。以下是一个定义了对此包1.x版本依赖的最小composer.json文件示例

{
    "require": {
        "data-values/common": "^1.1.0"
    }
}

测试

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

运行测试

仅测试

composer test

仅样式检查

composer cs

完整CI运行

composer ci

作者

DataValues Common是由维基数据团队编写的，由Wikimedia Germany的雇员为维基数据项目编写。

发行说明

1.1.0 (2022-10-21)

提高了与PHP 8.1的兼容性；特别是，现在实现了新的__serialize/__unserialize方法（除仍支持的Serializable接口外）。请确保还使用data-values/data-values版本3.1.0（或更高版本）以保持散列稳定。

1.0.0 (2021-01-22)

将最低所需PHP版本从5.5.9更新到7.2
添加了对data-values/data-values 3.x的兼容性
添加了对data-values/interfaces 1.x的兼容性
删除了DATAVALUES_COMMON_VERSION常量
已弃用DataValue实现中的getSortKey方法
ValueParsers\Test命名空间中的类现在是包私有。值得注意的是ValueParserTestBase和StringValueParserTest
StringFormatter构造函数不再接受选项
StringParser::parse现在抛出ParseException而不是InvalidArgumentException
添加了TrimmingStringNormalizer
将解析器类中的FORMAT_NAME常量设为私有

0.4.3 (2019-06-28)

修复了DispatchingValueParser中错误消息的拼写错误

0.4.2 (2018-08-16)

现在可以将组件与DataValues 2.x一起安装

0.4.1 (2017-08-09)

修复了未更新的版本号。

0.4.0 (2017-08-09)

已弃用MonolingualTextValue::newFromArray和MultilingualTextValue::newFromArray
MismatchingDataValueTypeException不再在构造函数中修改自定义错误消息
将最低所需PHP版本从5.3更新到5.5.9
更新了MediaWiki入口以使用extension.json格式

0.3.1 (2015-08-14)

现在可以将组件与DataValues Interfaces 0.1.5一起安装

0.3.0 (2015-08-11)

添加了DispatchingValueParser
添加了StringNormalizer接口
添加了 NullStringNormalizer
添加了 StringParser
删除了已弃用的常量 DataValuesCommon_VERSION，改为使用 DATAVALUES_COMMON_VERSION
删除了 ValueParserTestBase::getParserClass
删除了 ValueParserTestBase::newParserOptions
将 ValueParserTestBase::getInstance 声明为抽象方法
将 ValueParserTestBase::invalidInputProvider 声明为抽象方法
将所有类字段的可视性降低到私有

0.2.3 (2014-10-09)

在 ValueParsers 中引入了 FORMAT_NAME 类常量，以便作为 expectedFormat 使用
修改了 ValueParsers，使其在构造 ParseException 时传递 rawValue 和 expectedFormat 参数
现在支持与 DataValues 1.x 一起安装

0.2.2 (2014-04-11)

添加了 MismatchingDataValueTypeException

0.2.1 (2014-03-12)

进行了一些小的代码清理
改进了 PHPUnit 引导

0.2.0 (2013-12-16)

添加了 FloatParser（从 data-values/number 移动而来）
添加了 IntParser（从 data-values/number 移动而来）

0.1.1 (2013-11-22)

修复了 MediaWiki 信用链接

0.1.0 (2013-11-17)

首次发布包含这些功能

几个 DataValue 实现
- MonolingualTextValue
- MultilingualTextValue
几个 ValueFormatter 实现
- StringFormatter
几个 ValueParser 实现
- BoolParser
- DecimalParser
- NullParser

链接

DataValues Common 在 Packagist 上的包

data-values / common

维护者

详细信息