Common ValueValidator implementations
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

DataValues Validators

DataValues Validators is a small library that contains common ValueValidator implementations.

It is part of the DataValues set of libraries.

Build Status Code Coverage Scrutinizer Quality Score

On Packagist: Latest Stable Version Download count


The recommended way to use this library is via Composer.


To add this package as a local, per-project dependency to your project, simply add a dependency on data-values/validators to your project's composer.json file. Here is a minimal example of a composer.json file that just defines a dependency on version 1.0 of this package:

    "require": {
        "data-values/validators": "1.0.*"


Get the code of this package, either via git, or some other means. Also get all dependencies. You can find a list of the dependencies in the "require" section of the composer.json file. Then take care of autoloading the classes defined in the src directory.


This library comes with a set up PHPUnit tests that cover all non-trivial code. You can run these tests using the PHPUnit configuration file found in the root directory. The tests can also be run via TravisCI, as a TravisCI configuration file is also provided in the root directory.


DataValues Validators has been written by the Wikidata team, as Wikimedia Germany employees for the Wikidata project.

It is based upon and contains a lot of code written by Jeroen De Dauw for the Maps and Semantic MediaWiki projects.

Release notes

0.1.3 (2018-08-02)

  • Made component installable with DataValues 2.x
  • Removed MediaWiki integration

0.1.2 (2014-10-09)

  • Made component installable with DataValues 1.x

0.1.1 (2014-03-27)

  • Changed autoloading from PSR-0 to PSR-4
  • Added tests for DimensionValidator

0.1.0 (2013-11-17)

Initial release with these features:

  • DimensionValidator
  • ListValidator
  • NullValidator
  • RangeValidator
  • StringValidator
  • TitleValidator