Skip to content
This repository has been archived by the owner on Aug 3, 2018. It is now read-only.

thebigdb/thebigdb-php

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 

Repository files navigation

TheBigDB PHP Wrapper

A simple PHP wrapper for making requests to the API of TheBigDB.com. Full API documentation.

Simple usage

First, you need to initialize the class with:

require("thebigdb.php");
$thebigdb = new TheBigDB;

The following actions return a dict object from the parsed JSON the server answered.

Search (api doc)

# Usage: $thebigdb->search($nodes, $other_params = array());
$thebigdb->search(array("subject" => array("match" => "James"), "property" => "job", "answer" => "President of the United States"));
$thebigdb->search(array("subject" => "London", "property" => "population"), array("period" => array("on" => "2007-06-05")));
$thebigdb->search("iPhone"); # will fulltext search "iPhone" in all fields

Create (api doc)

# Usage: $thebigdb->create($nodes, $other_params = array());
$thebigdb->create(array("subject" => "iPhone 5", "property" => "weight", "answer" => "112 grams"));
$thebigdb->create(array("subject" => "Bill Clinton", "property" => "job", "answer" => "President of the United States"), array("period" => array("from" => "1993-01-20 12:00:00", "to" => "2001-01-20 12:00:00")))

Show (api doc), Upvote (api doc) and Downvote (api doc)

$thebigdb->show("id-of-the-sentence");

$thebigdb->upvote("id-of-the-sentence"); # don't forget to set your API key
$thebigdb->downvote("id-of-the-sentence"); # don't forget to set your API key

That's it!

Response

Each action returns an object translating the JSON answered by the server.
Example:

# Will print the id of the first statement matching that search
$response = $thebigdb->search(array("subject" => array("match" => "James"), "property" => "job", "answer" => "President of the United States"));
var_dump($response->statements[0]->id);

Other Features

You can access other parts of the API in the same way as statements:

# $thebigdb->user($action, $params);
# Examples
$response = $thebigdb->user("show", array("login" => "christophe"));
$response->user->karma;

Requirements

  • PHP 5.2+
  • curl extension

Contributing

Don't hesitate to send a pull request !

License

This software is distributed under the MIT License. Copyright (c) 2013, Christophe Maximin [email protected]

Releases

No releases published

Packages

No packages published

Languages