sweetrdf/easyrdf

EasyRdf is a PHP library designed to make it easy to consume and produce RDF.

1.4 2021-08-27 12:11 UTC

README

For more information about this fork, scroll at the end of this document.

CI

EasyRdf is a PHP library designed to make it easy to consume and produce RDF. It was designed for use in mixed teams of experienced and inexperienced RDF developers. It is written in Object Oriented PHP and has been tested extensively using PHPUnit.

After parsing EasyRdf builds up a graph of PHP objects that can then be walked around to get the data to be placed on the page. Dump methods are available to inspect what data is available during development.

Data is typically loaded into an EasyRdf\Graph object from source RDF documents, loaded from the web via HTTP. The EasyRdf\GraphStore class simplifies loading and saving data to a SPARQL 1.1 Graph Store.

SPARQL queries can be made over HTTP to a Triplestore using the EasyRdf\Sparql\Client class. SELECT and ASK queries will return an EasyRdf\Sparql\Result object and CONSTRUCT and DESCRIBE queries will return an EasyRdf\Graph object.

Example

$foaf = new \EasyRdf\Graph("http://njh.me/foaf.rdf");
$foaf->load();
$me = $foaf->primaryTopic();
echo "My name is: ".$me->get('foaf:name')."\n";

Requirements

  • PHP 7.1 or higher
  • PHP Extensions: dom, mbstring, pcre, xmlreader
  • PHP Libs: libxml

Features

  • No required external dependencies upon other libraries (PEAR, Zend, etc...)
  • Library runs in Linux and Windows environments
  • Extensive unit tests written using PHPUnit
  • Built-in parsers and serialisers: RDF/JSON, N-Triples, RDF/XML, Turtle
  • Optional parsing support for: ARC2, rapper
  • Optional support for Zend\Http\Client
  • Type mapper - resources of type foaf:Person can be mapped into PHP object of class Foaf_Person
  • Support for visualisation of graphs using GraphViz
  • Comes with a number of examples

List of Examples

Contributing

Contributions are welcome! Please read CONTRIBUTING.md for further information.

For further information about extending / hack EasyRdf please read DEVELOPER.md.

Further mainainers are possible, please send an email to @k00ni.

Running Examples

The easiest way of trying out some of the examples is to use the PHP command to run a local web server on your computer.

php -S localhost:8080 -t examples

Then open the following URL in your browser: http://localhost:8080/

Why this fork?

EasyRdf was in maintenance mode since 2017 (link) and not actively maintained since. There were 6+ pull requests pending at that time with fixes and new features. Its sad to see another RDF PHP project die slowly, so i decided to clean house and give the code a new home (old fork, further info). A few months in late 2020 EasyRdf was actively improved (me being a co-maintainer for a while), but that stopped and decay began again.

I decided to abandon my old fork to make use of latest EasyRdf improvements. Therefore this Github repository was created as a replacement for sweetyrdf/easyrdf.

What can you expect as a user?

This fork (v1.*) aims to be a drop-in replacement for the easyrdf/easyrdf package, which means, you can use it without changing your code. But you should still read the notes of the latest release, to make sure nothing unexpected happens after an update.

What can you expect as an EasyRdf developer?

This repository is set up in a way to lower the maintenance overhead in comparison to the original version. Test related tool was partly replaced with more lightweight solutions. Furthermore this repository is held by an organization instead of a user, which allows more flexible maintenance.

Licensing

The EasyRdf library and tests are licensed under the BSD-3-Clause license. The examples are in the public domain, for more information see UNLICENSE.