This library is no longer under development and is no longer maintained., (*1)
Ask
Library containing a PHP implementation of the Ask query language., (*2)
The implementation consists out of domain objects that represent various parts of Ask queries., (*3)
, (*4)
On Packagist:
, (*5)
Requirements
Installation
You can use Composer to download and install
this package as well as its dependencies. Alternatively you can simply clone
the git repository and take care of loading yourself., (*6)
Composer
To add this package as a local, per-project dependency to your project, simply add a
dependency on ask/ask to your project's composer.json file.
Here is a minimal example of a composer.json file that just defines a dependency on
Ask 1.0:, (*7)
{
"require": {
"ask/ask": "1.0.*"
}
}
Manual
Get the Ask code, either via git, or some other means. Also get all dependencies.
You can find a list of the dependencies in the "require" section of the composer.json file.
Load all dependencies and the load the Ask library by including its entry point:
Ask.php., (*8)
Structure
The Ask library defines the Ask query language. Its important components are:, (*9)
Description
Each query has a single description which specifies which entities match. This is similar to the
WHERE part of an SQL string. There different types of descriptions are listed below. Since several
types of descriptions can be composed out of one or more sub descriptions, tree like structures can
be created., (*11)
All descriptions reside in the Ask\Language\Description namespace., (*13)
Option
The options a query consist out of are defined by the QueryOptions class. This class
contains limit, offset and sorting options., (*14)
Sorting options are defined by the SortOptions class, which contains a list of
SortExpression objects., (*15)
All options related classes reside in the Ask\Language\Option namespace., (*16)
Selection
Specifying what information a query should select from matching entities is done via the selection
requests in the query object. Selection requests are thus akin to the SELECT part of an SQL string.
They thus have no effect on which entities match the query and are returned. All types of selection
request implement abstract base class SelectionRequest and can be found in the Ask\Language\Selection
namespace., (*17)
Usage
A query for the first hundred entities that are compared
use Ask\Language\Query;
use Ask\Language\Description\AnyValue;
use Ask\Language\Option\QueryOptions;
$myAwesomeQuery = new Query(
new AnyValue(),
array(),
new QueryOptions( 100, 0 )
);
A query with an offset of 50
$myAwesomeQuery = new Query(
new AnyValue(),
array(),
new QueryOptions( 100, 50 )
);
A query to get the ''cost'' of the first hundred entities that have a ''cost'' property
This is assuming 'p42' is an identifier for a ''cost'' property., (*18)
$awesomePropertyId = new PropertyValue( 'p42' );
$myAwesomeQuery = new Query(
new SomeProperty( $awesomePropertyId, new AnyValue() ),
array(
new PropertySelection( $awesomePropertyId )
),
new QueryOptions( 100, 0 )
);
A query to get the first hundred entities that have 9000.1 as value for their ''cost'' property.
This is assuming 'p42' is an identifier for a ''cost'' property., (*19)
$awesomePropertyId = new PropertyValue( 'p42' );
$someCost = new NumericValue( 9000.1 );
$myAwesomeQuery = new Query(
new SomeProperty( $awesomePropertyId, new ValueDescription( $someCost ) ),
array(),
new QueryOptions( 100, 0 )
);
A query getting the hundred entities with highest ''cost'', highest ''cost'' first
This is assuming 'p42' is an identifier for a ''cost'' property., (*20)
$awesomePropertyId = new PropertyValue( 'p42' );
$myAwesomeQuery = new Query(
new AnyValue(),
array(),
new QueryOptions(
100,
0,
new SortOptions( array(
new PropertyValueSortExpression( $awesomePropertyId, SortExpression::DESCENDING )
) )
)
);
A query to get the hundred first entities that have a ''cost'' either equal to 42 or bigger than 9000
This is assuming 'p42' is an identifier for a ''cost'' property., (*21)
$awesomePropertyId = new PropertyValue( 'p42' );
$costOf42 = new NumericValue( 42 );
$costOf9000 = new NumericValue( 9000 );
$myAwesomeQuery = new Query(
new SomeProperty(
$awesomePropertyId,
new Disjunction( array(
new ValueDescription( $costOf42 ),
new ValueDescription( $costOf9000, ValueDescription::COMP_GRTR ),
) )
),
array(),
new QueryOptions( 100, 0 )
);
Tests
This library comes with a set up PHPUnit tests that cover all non-trivial code. You can run these
tests using the PHPUnit configuration file found in the root directory. The tests can also be run
via TravisCI, as a TravisCI configuration file is also provided in the root directory., (*22)
Authors
Ask has been written by Jeroen De Dauw
as Wikimedia Germany employee for the Wikidata project., (*23)
This library is a reimplementation of the Ask language domain objects in
Semantic MediaWiki, which have been written by
Markus Krötzsch. This reimplementation is conceptually almost
entirely based on the original code and contains small portions of it., (*24)
Release notes
1.0.3 (alpha)
- Installation together with DataValues 2.x is now supported.
1.0.2 (2014-10-16)
- Installation together with DataValues 1.x is now supported.
1.0.1 (2014-01-21)
- Removed custom autoloader. The Composer support for PSR-4 is now used.
- The PHPUnit bootstrap file now automatically runs "composer update".
1.0 (2013-11-17)
Initial release with these features:, (*25)
- PHP implementation of the Ask language core
- Implementation of descriptions, selection requests and sort options initially needed for Wikidata
Links
Wallogit.com
