gbv/jskos

PHP library to access and serve JSKOS data and services

0.0.13 2016-10-18 10:50 UTC

README

Latest Stable Version License Total Downloads

Build Status Coverage Status ![Coding Style](https://img.shields.io/badge/coding style-PRS--2-green.svg) ![Logger Interface](https://img.shields.io/badge/logger interface-PRS--3-green.svg)

jskos is a PHP library for easy processing of knowledge organization systems (KOS) as classifications, thesauri, and authority files given in JSKOS data format. JSKOS is a JSON format based on Simple Knowledge Organisation System (SKOS).

Requirements

JSKOS-PHP works with PHP 5.6 or above. No additional libraries are required.

Installation

With composer

Install the latest version with

composer require gbv/jskos

This will automatically create composer.json for your project (unless it already exists) and add jskos as dependency. Composer also generates vendor/autoload.php to get autoloading of all dependencies:

require_once __DIR__ . '/vendor/autoload.php';

$concept = new JSKOS\Concept( [ "uri" => "http://example.org" ] );
echo $concept->json();

Manually without autoloading

Download the jskos library directory src and put it in a directory of your choice. Then include file JSKOS.php which includes all library files:

require_once 'src/JSKOS.php';

$concept = new JSKOS\Concept( [ "uri" => "http://example.org" ] );
echo $concept->json();

Usage and examples

API documentation is published at http://gbv.github.io/jskos-php/.

The jskos-php-examples repository contains several examples, including wrappers of existing terminology services (Wikidata, GND...) to JSKOS-API.

The examples can be tried online at https://jskos-php-examples.herokuapp.com.

Contributung

See CONTRIBUTUNG.md for technical details.

Bugs and feature request are tracked on GitHub.

Author and License

Jakob Voß jakob.voss@gbv.de

JSKOS-PHP is licensed under the LGPL license - see LICENSE.md for details.

See alse

JSKOS is created as part of project coli-conc: https://coli-conc.gbv.de/.

The current specification of JSKOS is available at http://gbv.github.io/jskos/.

The current specification of JSKOS API is available at http://gbv.github.io/jskos-api/.