datavalues / datavalues

Defines the DataValue interface and some trivial implementations

DataValues

Small PHP library that provides interfaces for Value Objects. Several libraries build on top of this foundation.

On Packagist:

Installation

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 3.x:

    {
        "require": {
            "data-values/data-values": "^3.1.0"
        }
    }

Running the tests

For tests only

composer test

For style checks only

composer cs

For a full CI run

composer ci

Authors

DataValues has been written primarily by Jeroen De Dauw, in part for the Wikidata project and Wikimedia Germany.

Contributions where also made by several other awesome people.

Release notes

3.1.0 (2022-10-21)

• Improved compatibility with PHP 8.1; in particular, the new __serialize/__unserialize methods are implemented now (in addition to the still supported Serializable interface). Care has been taken to keep the output of getHash() stable; if other classes include the PHP serialization of data values in their own hashes, they should instead use the new getSerializationForHash() method where it exists.

3.0.0 (2021-01-19)

• Removed getCopy from the DataValue interface and all implementations
• Removed getSortKey from the DataValue interface and all implementations
• Removed the Comparable, Hashable and Immutable interfaces
• Removed DATAVALUES_VERSION constant
• Removed DataValueTest (create a copy if you need it, though better refactor away the bad design)
• Raised minimum PHP version from 5.5.9 to 7.2

2.3.0 (2019-09-16)

• composer.json and phpunit.xml.dist are now included in releases

2.2.1 (2019-09-05)

• Fixed DataValueTest not being part of the release

2.2.0 (2019-09-05)

• Deprecated DATAVALUES_VERSION constant

2.1.1 (2017-09-28)

• Fixed DataValueTest not being installable via Composer

2.1.0 (2017-08-09)

• Removed MediaWiki integration

2.0.0 (2017-08-02)

• Dropped Copyable interface
• Dropped deprecated constant DataValues_VERSION, use DATAVALUES_VERSION instead
• Deprecated newFromArray in all DataValue implementations.
• Updated minimal required PHP version from 5.3 to 5.5.9
• Updated documentation throughout the code

1.1.1 (2017-11-02)

• Add .gitattributes file

1.1.0 (2017-08-09)

• Remove MediaWiki integration

1.0.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.0 (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

Links

• DataValues on Packagist
• DataValues on Ohloh

datavalues's Issues

3.0.0 release

TODO:

• Deal with #43
• Maybe kill https://github.com/DataValues/DataValues/tree/master/src/interfaces

Sync with (minimize https://www.entropywins.wtf/blog/2018/08/30/base-libraries-should-be-stable/ costs):

• https://github.com/DataValues/Common 1.0.0
• Maybe also https://github.com/DataValues/Interfaces 1.0.0

Please include composer.json and phpunit.xml.dist in release archives

Inclusion of composer.json and phpunit.xml.dist would greatly simplify testing of downloaded source release archives prior to using them. Moreover, composer.json contains a lot of metadata (machine-readable dependency list), which I think is worthy to have together with the source.

Fix PHP 8.1 deprecation warnings

Using PHP 8.1.6
PHP Deprecated: DataValues\Geo\Values\LatLongValue implements the Serializable interface, which is deprecated. Implement __serialize() and __unserialize() instead (or in addition, if support for old PHP versions is necessary) in /home/runner/work/Maps/Maps/mediawiki/vendor/data-values/geo/src/Values/LatLongValue.php on line 22