PHPackages                             missing-u/http-filter - 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. [HTTP & Networking](/categories/http)
4. /
5. missing-u/http-filter

ActiveLibrary[HTTP & Networking](/categories/http)

missing-u/http-filter
=====================

借助scope实现的对列表参数的过滤

1.0.0(6y ago)03MITPHPPHP >=7.2.0

Since Aug 20Pushed 5y ago1 watchersCompare

[ Source](https://github.com/missing-u/http-filter)[ Packagist](https://packagist.org/packages/missing-u/http-filter)[ RSS](/packages/missing-u-http-filter/feed)WikiDiscussions master Synced today

READMEChangelogDependenciesVersions (2)Used By (0)

### 参数过滤

[](#参数过滤)

### 原出处:

[](#原出处-httpslaracastscomserieseloquent-techniquesepisodes4)

### 想法(或者说目的)

[](#想法或者说目的)

```
对于列表的查询　
往往伴随较多的筛选(包含查询)条件　
这些筛选条件往往作用于 model 之上
其中有一些筛选条件是公共的　
例如分页数,每页的数量,对id的倒序
对每一个列表重复这些将使逻辑部分代码变得臃肿
基于这样一种经验:
当我们需要修改代码或者排查问题的时候(列表接口)
对传递的过滤条件参数是较少关心的
或者说关注点是分离的
即
要么关心为什么传了某个过滤参数导致错误(不生效或者没数据等等)
要么关心的是不传递任何参数下 返回数据是什么样子的(为什么不符合预期)

由此产生一个朴素的想法
将这些冗长的过滤条件拆分到单独的类 (filter类)
一个筛选条件对应类中的一个方法(方便起见,约定 参数名与方法名相同)
将公共常用的筛选条件抽取到一个trait以便复用
借由laravel的scope得以实现这一想法

```

### 对这些筛选条件的分类

[](#对这些筛选条件的分类)

```
这种分类方式未必合理 更多体现的是处理的细节
将筛选条件分为两类
第一类
通过 http 请求 显式传递过来的 有则过滤 没有则不额外处理
比如 GET|POST 允许传递参数 name
如果传递 name = 'yang'
则筛选 name like '%yang%'的记录
如果不传递 则不处理
第二类
不是通过 http 请求传递过来的 或者不论是否通过http请求传递参数
过滤条件都需要生效
比如 order by 这个过滤条件

对于第一类过滤条件
我们对传递过来的参数做遍历
对于每一个参数 如果存在与参数名相同的函数 则调用这个函数

对于第二类过滤条件
我们可以在 __construct 中手动调用
但是特别的 因为这些条件使用的非常频繁
出于编码的简洁的目的
我们做如下约定

当 filter类中 存在 匹配 auto_invoked_register_%s  这样格式的静态属性名时
我们将会调用 以 这个属性对应的值 为函数名的函数
理论上 %s 这个地方填写什么都可以
它的作用是防止引入多个 trait  时候 属性名冲突
约定
一般情况下 令 %s = 这个属性的值

示例
    本项目下 src/IsolatedFilter/OrderByFilter.php 文件中的 OrderByFilter 类
存在属性
    static $invoke_regardless_request_order_by = 'order_by'
那么 order_by 函数将会被调用

```

### 示例

[](#示例)

##### 不使用 Filter

[](#不使用-filter)

```

$pass_params = request()->all();

$where = [];

if (isset($pass_params[ 'mobile' ])) {
    $where[ 'mobile' ] = [
        'mobile','like',$pass_params['mobile']
    ];
}

if (isset($pass_params[ 'idcard' ])) {
    $where[ 'idcard' ] = [
        'idcard','like',$pass_params['idcard']
    ];
}

if (isset($pass_params[ 'from' ])) {
    $where[ 'from' ] = [
        'created_time','>=',$pass_params['from']
    ];
}

if (isset($pass_params[ 'to' ])) {
    $where[ 'to' ] = [
        'created_time','>=',$pass_params['to']
    ];
}

Person::where(
    $where
);

```

##### 使用 Filter

[](#使用-filter)

```

class PersonIndexFilter extends \HttpFilter\Filter
{
    use \HttpFilter\IsolatedFilter\TimePeriod;

    public function __construct($request)
    {
        parent::__construct($request);

        //如果 字段是 created_at
        //那么就不用调用下面这里
        //哪这个举个例子
        $this->setTimeColumnName('create_time');
    }

    public function mobile(int $mobile)
    {
        $this->builder->where(
            'mobile', 'like', $mobile
        );
    }

    public function idcard(string $idcard)
    {
        $this->builder->where(
            'idcard', 'like', $idcard
        );
    }
}

$filter = new PersonIndexFilter(request());

Person::addGlobalScope($filter);

TpShopInfo::first();

```

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity3

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 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

Unknown

Total

1

Last Release

2456d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/0fb66c16f123d51ad5ead7593a7052bec5abc7be6db4abb6d84a465866097c52?d=identicon)[FlyInTheSea](/maintainers/FlyInTheSea)

---

Top Contributors

[![missing-u](https://avatars.githubusercontent.com/u/8327028?v=4)](https://github.com/missing-u "missing-u (4 commits)")

### Embed Badge

![Health badge](/badges/missing-u-http-filter/health.svg)

```
[![Health](https://phpackages.com/badges/missing-u-http-filter/health.svg)](https://phpackages.com/packages/missing-u-http-filter)
```

###  Alternatives

[friendsofsymfony/rest-bundle

This Bundle provides various tools to rapidly develop RESTful API's with Symfony

2.8k73.3M319](/packages/friendsofsymfony-rest-bundle)[php-http/discovery

Finds and installs PSR-7, PSR-17, PSR-18 and HTTPlug implementations

1.3k309.5M1.2k](/packages/php-http-discovery)[nyholm/psr7

A fast PHP7 implementation of PSR-7

1.3k235.4M2.4k](/packages/nyholm-psr7)[pusher/pusher-php-server

Library for interacting with the Pusher REST API

1.5k94.8M291](/packages/pusher-pusher-php-server)[spatie/crawler

Crawl all internal links found on a website

2.8k16.3M52](/packages/spatie-crawler)[react/http

Event-driven, streaming HTTP client and server implementation for ReactPHP

78126.4M414](/packages/react-http)

PHPackages © 2026

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