Download the PHP package wikibase/internal-serialization without Composer

On this page you can find all versions of the php package wikibase/internal-serialization. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package internal-serialization

Wikibase Internal Serialization

Library containing serializers and deserializers for the data access layer of Wikibase Repository.

Build Status Code Coverage Scrutinizer Quality Score

On Packagist: Latest Stable Version Download count

Installation

The recommended way to use this library is via Composer.

Composer

To add this package as a local, per-project dependency to your project, simply add a dependency on wikibase/internal-serialization to your project's composer.json file. Here is a minimal example of a composer.json file that just defines a dependency on version 2.x of this package:

{
    "require": {
        "wikibase/internal-serialization": "~2.0"
    }
}

Manual

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.

Library usage

Construct an instance of the deserializer or serializer you need via the appropriate factory.

The use the deserialize or serialize method.

In case of deserialization, guarding against failures is good practice. So it is typically better to use the slightly more verbose try-catch approach.

All access to services provided by this library should happen through the SerializerFactory and DeserializerFactory. The rest of the code is an implementation detail which users are not allowed to know about.

Library structure

The Wikibase DataModel objects can all be serialized to a generic format from which the objects can later be reconstructed. This is done via a set of Serializers\Serializer implementing objects. These objects turn for instance a Claim object into a data structure containing only primitive types and arrays. This data structure can thus be readily fed to json_encode, serialize, or the like. The process of reconstructing the objects from such a serialization is provided by objects implementing the Deserializers\Deserializer interface.

Serializers can be obtained via an instance of SerializerFactory and deserializers can be obtained via an instance of DeserializerFactory. You are not allowed to construct these serializers and deserializers directly yourself or to have any kind of knowledge of them (ie type hinting). These objects are internal to this serialization and might change name or structure at any time. All you are allowed to know when calling $serializerFactory->newEntitySerializer() is that you get back an instance of Serializers\Serializer.

The library contains deserializers that handle the legacy internal serialization format. Those can be found in Wikibase\InternalSerialization\Deserializers, and all start with the word "Legacy". The remaining deserializers in this namespace are not specific to any format. They detect the one that is used and forward to the appropriate deserializer. These deserializers can thus deal with serializations in the old legacy format and those in the new one.

The DeserializerFactory only returns deserializers that can deal with both the legacy and the new format.

Tests

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.

Authors

Wikibase Internal Serialization has been written by Jeroen De Dauw, partially as Wikimedia Germany employee for the Wikidata project.

Links

See also


All versions of internal-serialization with dependencies

PHP Build Version
Package Version
Requires php Version ^7.0
wikibase/data-model Version ~9.0|~8.0
wikibase/data-model-serialization Version ~2.0
serialization/serialization Version ~4.0|~3.2
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package wikibase/internal-serialization contains the following files

Loading the files please wait ....