PHPackages                             railken/lara-eye - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Database & ORM](/categories/database)
4. /
5. railken/lara-eye

ActiveLibrary[Database & ORM](/categories/database)

railken/lara-eye
================

v3.0.2(2y ago)3938.9k24MITPHPPHP >=8.1

Since May 2Pushed 2y ago3 watchersCompare

[ Source](https://github.com/railken/lara-eye)[ Packagist](https://packagist.org/packages/railken/lara-eye)[ RSS](/packages/railken-lara-eye/feed)WikiDiscussions master Synced 4w ago

READMEChangelogDependencies (5)Versions (20)Used By (4)

Laravel Eye
===========

[](#laravel-eye)

[![Actions Status](https://github.com/railken/lara-eye/workflows/Test/badge.svg)](https://github.com/railken/lara-eye/actions)

Filter your `Illuminate\DataBase\Query\Builder` using a structured query language. This can be pretty usefull when you're building an API and you don't want to waste hours of your time creating predefined filters that may change at any time.

Requirements
------------

[](#requirements)

PHP 8.1 or later.

Usage
-----

[](#usage)

```
use Railken\LaraEye\Filter;
use Railken\SQ\Exceptions\QuerySyntaxException;
use App\Foo;

// Instance of Illuminate\DataBase\Query\Builder
$query = (new Foo())->newQuery()->getQuery();

$str_filter = "x > 5 or y < z";

$filter = new Filter("foo", ['id', 'x', 'y', 'z', 'created_at', 'updated_at']);

try {
    $filter->build($query, $str_filter);
} catch (QuerySyntaxException $e) {
    // handle syntax error
}
```

Syntax [here](https://github.com/railken/search-query)

Composer
--------

[](#composer)

You can install it via [Composer](https://getcomposer.org/) by typing the following command:

```
composer require railken/lara-eye
```

Demo
----

[](#demo)

[![demo](https://raw.githubusercontent.com/railken/lara-eye/master/demo/demo.gif)](https://raw.githubusercontent.com/railken/lara-eye/master/demo/demo.gif)

License
-------

[](#license)

Open-source software licensed under the [MIT license](https://opensource.org/licenses/MIT).

###  Health Score

42

—

FairBetter than 88% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity35

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity81

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~120 days

Recently: every ~386 days

Total

19

Last Release

854d ago

Major Versions

v1.4.1 → v2.0.02020-01-13

v2.1.0 → v3.0.02024-03-27

PHP version history (3 changes)v1.0.0PHP &gt;=7.0.0

v1.1.0PHP &gt;=7.1

v3.0.0PHP &gt;=8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/ea4a9e56b247008aea4d20bb8a555a9f0cb69d0ac69aa8417b29fc37efa2eb5c?d=identicon)[railken](/maintainers/railken)

---

Top Contributors

[![railken](https://avatars.githubusercontent.com/u/26530231?v=4)](https://github.com/railken "railken (79 commits)")

---

Tags

apicomposereloquentfilterlaravellibraryphpquerysearchapi

###  Code Quality

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/railken-lara-eye/health.svg)

```
[![Health](https://phpackages.com/badges/railken-lara-eye/health.svg)](https://phpackages.com/packages/railken-lara-eye)
```

###  Alternatives

[spatie/laravel-medialibrary

Associate files with Eloquent models

6.2k45.4M681](/packages/spatie-laravel-medialibrary)[mongodb/laravel-mongodb

A MongoDB based Eloquent model and Query builder for Laravel

7.1k8.9M106](/packages/mongodb-laravel-mongodb)[kirschbaum-development/eloquent-power-joins

The Laravel magic applied to joins.

1.6k35.7M51](/packages/kirschbaum-development-eloquent-power-joins)[yajra/laravel-oci8

Oracle DB driver for Laravel via OCI8

8723.3M27](/packages/yajra-laravel-oci8)[psalm/plugin-laravel

Psalm plugin for Laravel

3345.4M353](/packages/psalm-plugin-laravel)[glushkovds/phpclickhouse-laravel

Adapter of the most popular library https://github.com/smi2/phpClickHouse to Laravel

2051.6M2](/packages/glushkovds-phpclickhouse-laravel)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)