2017 © Pedro Peláez
 

library qriteria

Automatic url parameter mapping to sort, filter, include and select data in an easy to use fluent api within Laravel 5. The default parameter structure is compatible to the http://jsonapi.org specification.

image

ricktap/qriteria

Automatic url parameter mapping to sort, filter, include and select data in an easy to use fluent api within Laravel 5. The default parameter structure is compatible to the http://jsonapi.org specification.

  • Saturday, August 13, 2016
  • by ricktap
  • Repository
  • 2 Watchers
  • 6 Stars
  • 35 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 0 Forks
  • 0 Open issues
  • 5 Versions
  • 0 % Grown

The README.md

Qriteria

Home of Qriteria: https://github.com/ricktap/Qriteria, (*1)

Qriteria is a frankenword containing the terms Query and Criteria. It is intended to take the $_GET Parameters of a request and maps the words *filter*, *fields*, *sort*, *include* and *limit* as described in the JSON API Specification to the query of an eloquent model., (*2)

Qriterias fluent Api allows for three query hooks: - class based pre-hooks, that are run before every query it sends on every instance of your model - on-call queries, that are called before the translation but after your pre-hook and only for this one instance object - method-based queries, those are called after the translation and can be used like a scope method in eloquent, (*3)

Installation

composer require ricktap/qriteria

add the following to your config/app.php inside the providers array, (*4)

RickTap\Qriteria\QriteriaServiceProvider::class,

Configuration

To configure Qriteria, you can generate the config/qriteria.php config file by running the command:, (*5)

php artisan vendor:publish

Filtering

Syntax:

filter=name:like:John%,(age:gt:60|age:lt:20),status:eq:occupied

Result:

$query->where("name","LIKE","John%")->where(function ($q) { 
  return $q->where("age",">",60)->orWhere("age","<",20);
})->where("status","=","occupied");

Description:

Every filter statement consists of three parts, separated by colons (:). The first part represents the field to query, the second part is the operation, that is available as a symbol or a word (i.e. you can use = or eq for the same thing) the third part is the value to compare to. the filter statements are separated by a comma (,) or a pipe (|). The comma means and the pipe means or. Statements can be wrapped into parenthesis like in a mathematical function, to sort their execution sequence., (*6)

Todo

  • Write a more exhaustive documentation and maybe even a wiki
  • Write more tests
  • Have more checks in place
  • Map eq to =, lt to <, etc.
  • Split the searchable trait into two separate traits. one for filter and one for qriteria itself
  • further validate the user input, right now the only thing I'm doing is a check on the parentheses to see if they are balanced and in order

The Versions

13/08 2016

dev-master

9999999-dev https://github.com/ricktap/Qriteria

Automatic url parameter mapping to sort, filter, include and select data in an easy to use fluent api within Laravel 5. The default parameter structure is compatible to the http://jsonapi.org specification.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Patrick Selge

laravel api json filter search sort relations

13/08 2016

0.6.1

0.6.1.0 https://github.com/ricktap/Qriteria

Automatic url parameter mapping to sort, filter, include and select data in an easy to use fluent api within Laravel 5. The default parameter structure is compatible to the http://jsonapi.org specification.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Patrick Selge

laravel api json filter search sort relations

12/08 2016

0.6.0

0.6.0.0 https://github.com/ricktap/Qriteria

Automatic url parameter mapping to sort, filter, include and select data in an easy to use fluent api within Laravel 5. The default parameter structure is compatible to the http://jsonapi.org specification.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Patrick Selge

laravel api json filter search sort relations

12/08 2016

0.5.0

0.5.0.0 https://github.com/ricktap/Qriteria

Automatic url parameter mapping to sort, filter, include and select data in an easy to use fluent api within Laravel 5. The default parameter structure is compatible to the http://jsonapi.org specification.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Patrick Selge

laravel api json filter search sort relations

11/08 2016

0.3.0

0.3.0.0 https://github.com/ricktap/Qriteria

Automatic url parameter mapping to sort, filter, include and select data in an easy to use fluent api within Laravel 5. The default parameter structure is compatible to the http://jsonapi.org specification.

  Sources   Download

MIT

The Requires

  • php ^5.6 || ^7.0

 

by Patrick Selge

laravel api json filter search sort relations