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 3w 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 89% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity33

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

809d 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

[kirschbaum-development/eloquent-power-joins

The Laravel magic applied to joins.

1.6k29.9M42](/packages/kirschbaum-development-eloquent-power-joins)[yajra/laravel-oci8

Oracle DB driver for Laravel via OCI8

8723.1M23](/packages/yajra-laravel-oci8)[glushkovds/phpclickhouse-laravel

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

2051.4M2](/packages/glushkovds-phpclickhouse-laravel)[api-platform/laravel

API Platform support for Laravel

59156.3k11](/packages/api-platform-laravel)[laravel-liberu/laravel-gedcom

A package that converts gedcom files to Eloquent models

782.5k1](/packages/laravel-liberu-laravel-gedcom)[itpathsolutions/dbstan

Database Standardization and Analysis Tool for Laravel

442.1k](/packages/itpathsolutions-dbstan)

PHPackages © 2026

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