jamesfrost/wikidata

A PHP client for working with Wikidata API.

Wikidata

Wikidata provides a API for searching and retrieving data from wikidata.org., _(*1)

Installation

composer require freearhey/wikidata

Usage

$wikidata = new Wikidata;

Search

Search by entity title:, _(*2)

$result = $wikidata->search('steve jobs');

Check if no search results, _(*3)

if($result->isEmpty()) {
    echo 'no results';
    die();
}

Retrieve first entity in result list, _(*4)

$singleResult = $result->first();

Retrieve all results, _(*5)

$allResults = $result->get();

Get entity id, _(*6)

$entityId = $singleResult->getEntityId(); // Q26

Entities

Get single entity by id:, _(*7)

$entities = $wikidata->entities('Q26');

Get single entity with preset language (default: en), _(*8)

$entities = $wikidata->entities('Q26', 'fr');

Get few entities by id and more languages, _(*9)

$entities = $wikidata->entities('Q26|Q106', 'en|fr|ch');

Retrieve first entity, _(*10)

$entity = $entities->first();

Get all entities, _(*11)

$entity = $entities->get();

Get single entity by id, _(*12)

$entity = $entities->get('Q26');

Get entity label and description (default language: en), _(*13)

$label = $entity->getLabel(); // Steve Jobs
$description = $entity->getDescription('de'); // US-amerikanischer Unternehmer, Mitbegründer von Apple Computer

Get entity property values by property id (e.g. P21) if it exists. All list properties you can find here, _(*14)

$gender = $entity->getPropertyValues('P21'); // array(1) { [0]=> string(4) "male" }

And with language property (default: en), _(*15)

$childs = $entity->getPropertyValues('P40', 'ru'); // array(1) { [0]=> string(35) "Бреннан-Джобс, Лиза" }

That's all., _(*16)

License

Wikidata is licensed under the MIT license, _(*17)