BlueSpice MediaWiki REL1_27
 All Classes Namespaces Files Functions Variables Groups Pages

DataValues is a small PHP library that aims to be a common foundation for representing "simple" values. Values such as numbers, geographical coordinates, strings and times.

It is part of the DataValues set of libraries.

![Build Status]( ![Code Coverage]( ![Scrutinizer Quality Score](

On Packagist: ![Latest Stable Version]( ![Download count](


  • PHP 5.3 or later


You can use Composer to download and install this package as well as its dependencies. Alternatively you can simply clone the git repository and take care of loading yourself.


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

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


Get the DataValues code, 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. Load all dependencies and the load the DataValues library by including its entry point: DataValues.php.


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 has been written primarily by Jeroen De Dauw, in part as Wikimedia Germany employee for the Wikidata project.

Contributions where also made by several other awesome people.

Release notes

1.1.0 (2017-08-09)

1.0 (2014-09-26)

  • The CI now ensures compatibility with PHP 5.6 and HHVM
  • A lot of type hints where improved
  • Protected methods and fields where changed to private
  • The test bootstrap no longer executes composer update
  • The test bootstrap now sets PHP strict mode
  • The contract of the Hashable::getHash method was updated
  • The MediaWiki internationalization support has been migrated to the JSON based version

0.1.1 (2013-11-22)

  • Removed support for running the tests via the MediaWiki test runner.
  • The test bootstrapping file now automatically does a composer install.
  • Removed custom autoloader in favour of defining autoloading in composer.json.

0.1 (2013-11-16)

Initial release with these features:

  • DataValue interface
    • BooleanValue implementation
    • NumberValue implementation
    • StringValue implementation
    • UnDeserializableValue implementation
    • UnknownValue implementation
  • Common interface definitions: Comparable, Copyable, Hashable, Immutable