To get access to ARC2 classes, configure ARC2's path (config.yml)
sw_arc2:
arc2_path: %kernel.root_dir%/../vendor/arc2/
Include this bundle as usual. You will only have to import one service to have access to all ARC2. For example, in a controller:
$this->get('sw_arc2')
You want to use DBpedia? Include the ARC2 service, use the convenience class Sw\Arc2Bundle\Sparql\DbPedia:
$this->get('sw_arc2');
\Sw\Arc2Bundle\Sparql\DbPedia::getRdfsLabelRegex('Europe');
You can issue arbitrary SPARQL request to DBpedia too:
$this->get('sw_arc2');
\Sw\Arc2Bundle\Sparql\DbPedia::request("your SPARQL request");
You can also use directly the underlying helper class to make queries to other servers:
$this->get('sw_arc2');
\Sw\Arc2Bundle\Sparql\DistantSparqlEndpoint::request("endpoint's URL", "your SPARQL request");
If you are going to make many requests, it would be best to create a class for this endpoint, and create within static methods for your
requests (you could add there a bit of caching, if you need to) - just to make code easier to read.
You want a local SPARQL endpoint? They need more configuration:
sw_arc2:
arc2_path: %kernel.root_dir%/../vendor/arc2/
# The database to use (only MySQL, requirement from ARC2).
database:
host: localhost
user: root
password: ~
database: symfony
# Configuration for the SPARQL endpoint
sparql_endpoint:
# Whether the endpoint will be served at the next URL (@todo)
active: true
# The URL where the endpoint will be automatically served (@todo)
url: /sparql
# The store where triples are to be found (table prefix)
store: sandbox
# Whether the tables are to be created if non existent
autocreate: false
timeout: 60
read_key: ~
write_key: ~
limit: 250
features:
select: true
construct: true
ask: true
describe: true
load: true
insert: true
delete: true
dump: true
As of now, you cannot configure the URL from the configuration (there's a hope this will be implemented one day or another). Instead,
it will always be served on the following URL once its routes are imported (relatively to what prefix you decided for this bundle's routes):
/sparql/
If you prefer, just imitate the called controller and do the following in one of your actions:
$this->get('sw_arc2.sparql')->drawEndpoint();
The two methods will output directly the endpoint interface, without any chance for you to catch it. If you need it, you can try:
$this->get('sw_arc2.sparql')->getEndpointData();
However, this is not really tested and could interfere with many things, as ARC2 is doing many things in the hood. This method should probably
be reimplemented properly.