Download the PHP package professional-wiki/sparql without Composer
On this page you can find all versions of the php package professional-wiki/sparql. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download professional-wiki/sparql
More information about professional-wiki/sparql
Files in professional-wiki/sparql
Package sparql
Short Description Allows running SPARQL queries via lua
License GPL-2.0-or-later
Homepage https://github.com/ProfessionalWiki/SPARQL
Informations about the package sparql
SPARQL
MediaWiki extension for executing SPARQL queries and templating their results via Lua.
Professional.Wiki created and maintains SPARQL. We provide Wikibase hosting, Wikibase development, MediaWiki development, and Wikibase consulting.
Table of Contents
- Usage
- Installation
- PHP Configuration
- Development
- Release notes
Usage Documentation
Define a lua module that requires the SPARQL
binding and uses its runQuery method.
Example: create page Module:MySPARQL
:
Which can then be invoked via Scribunto's normal mechanisms from within wikitext. Example:
{{#invoke:MySPARQL|showFirstValue|your SPARQL query here}}
Lua module examples:
- Show the first value (README example)
- Show everything
- Build an HTML table
Installation
Platform requirements:
- PHP 8.1 or later (tested up to 8.2)
- MediaWiki 1.39 or later (tested up to 1.42-dev)
- Scribunto and lua
We also recommend installing the CodeEditor extension for a better editing experience of Lua modules.
Installing The SPARQL Extension
The recommended way to install the SPARQL extension is using Composer with MediaWiki's built-in support for Composer.
On the commandline, go to your wikis root directory. Then run these two commands:
Then enable the extension by adding the following to the bottom of your wikis LocalSettings.php file:
You can verify the extension was enabled successfully by opening your wikis Special:Version page.
PHP Configuration
Configuration can be changed via LocalSettings.php.
SPARQL Endpoint URL
Variable: $wgSPARQLEndpoint
Required for the extension to function. You can enable the extension without setting this variable without breaking your wiki, but the extension will not work.
Example:
Development
Run composer install
in extensions/SPARQL/
to make the code quality tools available.
Running Tests and CI Checks
You can use the Makefile
by running make commands in the SPARQL
directory.
make ci
: Run everythingmake test
: Run all testsmake phpunit --filter FooBar
: run only PHPUnit tests with FooBar in their namemake phpcs
: Run all style checksmake cs
: Run all style checks and static analysis
Updating Baseline Files
Sometimes Psalm and PHPStan generate errors or warnings we do not wish to fix.
These can be ignored by adding them to the respective baseline file. You can update
these files with make stan-baseline
and make psalm-baseline
.
Release Notes
Version 1.0.0 - 2023-11-24
- Lua binding
SPARQL.runQuery
to execute SPARQL queries and return the results as a Lua table - Compatibility with MediaWiki 1.39, 1.40 and 1.41
- Compatibility with PHP 8.1 and 8.2
All versions of sparql with dependencies
composer/installers Version ^2|^1.0.1
jeroen-de-dauw/file-fetcher Version ^6.1.0