使用 RequestCriteria 统一搜索功能，可自动根据 url 按字段进行搜索，无需写方法

1. 后台搜索框的基本代码：

<div class="panel-group">
    <div class="panel panel-default" style="border: none;">
        <div class="panel-heading">
            <h4 class="panel-title">
                <a data-toggle="collapse" href="#wrapper_search"
                   aria-expanded="false" @if(false == $searchMode)class="collapsed" @endif >
                    搜索相关
                </a>
            </h4>
        </div>
        <div id="wrapper_search" class="panel-collapse collapse @if(true == $searchMode)in @endif"
             aria-expanded="false">
            <div class="panel-body">
                <div class="portlet-heading">
                    <form id="frm_search_info" class="text-dark form-horizontal" action="">
                        <input type="hidden" value=""/>
                        <div class="form-group col-sm-4 pull-left">
                            <label for="order_sn" class="control-label col-sm-4">订单号</label>

                            <div class="col-sm-8">
                                <input type="text" class="form-control" id="title" name="id"
                                       value="{{isset($searchCondition['id'])?$searchCondition['id']:''}}"/>

                            </div>
                        </div>

                        <div class="form-group col-sm-4 pull-left">
                            <label for="snap_goods_name" class="control-label col-sm-4">商品名称</label>

                            <div class="col-sm-8">
                                <input type="text" class="form-control" id="title" name="snap_goods_name"
                                       value="{{isset($searchCondition['snap_goods_name'])?$searchCondition['snap_goods_name']:''}}"/>

                            </div>
                        </div>

                        <div class="form-group col-sm-4 pull-left">
                            <label for="paymentInfo.payment_type" class="control-label col-sm-4">支付方式</label>

                            <div class="col-sm-8">
                                <select class="form-control input-lg select2" id="paymentInfo.payment_type" name="paymentInfo.payment_type"
                                        style="width: 192px;">
                                    <option value="">全部</option>
                                    @if(isset($paymentType))
                                        @foreach($paymentType as $index => $item)
                                            <option value="{{$index}}"
                                                    @if(isset($searchCondition['paymentInfo.payment_type']) && $index == $searchCondition['paymentInfo.payment_type']) selected="selected" @endif>{{$item}}</option>
                                        @endforeach
                                    @endif
                                </select>

                            </div>
                        </div>
                        <div class="form-group col-sm-4 pull-left">
                            <label for="created_at@" class="control-label col-sm-4">至</label>

                            <div class="col-sm-8">
                                <div class="input-group datetimepicker date" id="end_time_picker">
                                    <input class="form-control" id="created_at@"
                                           name="created_at@" type="text"
                                           value="@if(isset($searchCondition['created_at@']) && $searchCondition['created_at@']){{$searchCondition['created_at@']}}@endif">
                                    <span class="input-group-addon" for="created_at@">
                            <span class="glyphicon glyphicon-calendar"></span>
                        </span>
                                </div>

                            </div>
                        </div>

                        <div class="form-group col-sm-4 pull-right">
                            <button type="button" class="btn btn-default m-l-10" id="btn_clear">清空</button>
                            <button type="button" class="btn btn-purple m-l-10" id="btn_export">
                                Excel 导出
                            </button>
                            <button type="button" class="btn btn-primary m-l-10" id="btn_search">搜索</button>

                        </div>

                        <div class="clearfix"></div>

                    </form>
                </div>
            </div>
        </div>
    </div>

</div>

要求表单中的 name 与数据表中的字段名完全一致。
注意：这里是 button，而不是 submit

2. 在YourModelRepositoryEloquent.php (如FlashRepositoryEloquent.php) 中添加 $fieldSearchable 字段

如：

protected $fieldSearchable = [
    'id',
    'snap_goods_name' => 'like',
    'username',
    'order_status',
    'created_at' => ">=",
    'created_at@' => "<=",
    'source_id',
    'paymentInfo.payment_type'
];

注意：

• 要列出所有需要进行搜索的字段。
• 等于的可以省略，
• 模糊搜索用 like，
• 范围搜索也直接写。
• 如果一个字段需要用一次以上，需要对 key 进行重写，加一个@

其中，最后一个功能是在 BaseRepositoryEloquent 中定义的。

默认的键值间的分隔符为：， 如http://prettus.local/users?search=name:John Doe;email:john@gmail.com
可以进行自定义。
在 BaseRepositoryEloquent.php 的构造方法中，
$this->keyValueSeparator = '|:'。

组件中默认不包含范围选择符，即sql中的between用法。我们进行了改写，以支持该用法。

BaseRepositoryEloquent 中，添加解析搜索url的方法。

public function parserSearchData($searchData)
{
    if (!empty($searchData) && is_array($searchData)) {
        foreach ($searchData as $index => $item) {
            $method = sprintf("parser%s4Search", ucfirst(camel_case(str_replace('@', '', $index))));
            $model = $this->getModel();
            if (method_exists($model, $method)) {
                $searchData[$index] = $model->{$method}($item);
            }
        }
    }

    return $searchData;
}

以及解析原始搜索数据的方法

public function parserOriginSearchData($search)
{
    $searchData = [];
    if (stripos($search, $this->keyValueSeparator)) {
        $fields = explode($this->paramSeparator, $search);

        foreach ($fields as $row) {
            try {
                list($field, $value) = explode($this->keyValueSeparator, $row);
                $searchData[trim($field)] = trim($value);
            } catch (\Exception $e) {
                //Surround offset error
            }
        }
    }
    return $searchData;
}

业务需要，添加了整合后的获取搜索参数的方法

public function getSearchData($param = null, $is_origin = true)
{
    $search = $this->request->get(config('repository.criteria.params.search', 'search'), null);
    $searchData = $this->parserOriginSearchData($search);
    if (false == $is_origin) {
        $searchData = $this->parserSearchData($searchData);
    }
    if (!empty($param)) {
        if (isset($searchData[$param])) {
            $searchData = $searchData[$param];
        } else {
            $searchData = null;
        }
    }
    return $searchData;
}

3. js 文件中添加解析url的方法。

// 搜索 按钮
searchWithParams('/magazine/order?page=1');

function searchWithParams(url) {
    $("#btn_search").click(function () {
        var params = {};
        $("#frm_search_info select, #frm_search_info input[type=text], #frm_search_info input[type=hidden]").each(function () {
            var value = $(this).val();
            if ('' != value) {
                params[$(this).attr('name')] = value;
            }
        });

        if (!$.isEmptyObject(params)) {
            url += "&search=" + parserParams2Url(params);
        }

        location.href = url;
    });

}

该方法实现了对所有输入框、下拉框等搜索框内容的收集并处理，生成一个 Repository 可解析的 url。

4. 回显的数据不需要通过控制器获取后回传，在模板中通过 $searchCondition 全局变量获取即可

如何使用？
控制器中的方法会非常简洁：

public function getIndex(Request $request)
{
    $flashes = $this->repositoryInterface->paginate();

    return View::make("flash/index", array(
        "flashes" => $flashes,
        "flashTypes" => Flash::$flashTypes,
    ));
}

---

第二部分

上述搜索方法只是实现了单表搜索，如果搜索涉及到跨表该怎么处理？

场景：在模型Order的列表页进行搜索，但搜索的关键字是模型Payment的一个字段，模型Payment有一个指向模型Order的外键 order_id。

实现：

1. 在 app/Models/Order 中，建立与 Payment 模型的关联关系。

/**
 * 支付信息关联关系
 * @return \Illuminate\Database\Eloquent\Relations\HasOne
 */
public function paymentInfo()
{
    return $this->hasOne('App\Models\Payment', 'order_id', 'id');
}

2. Order 的模板文件（列表 resources/views/backend/order/index.blade.php）中，搜索相关部分的 name 和字段名都要加上关联关系的方法前缀。

<div class="form-group col-sm-4 pull-left">
    <label for="paymentInfo.payment_type" class="control-label col-sm-4">支付方式</label>

    <div class="col-sm-8">
        <select class="form-control input-lg select2" id="paymentInfo.payment_type" name="paymentInfo.payment_type"
                style="width: 192px;">
            <option value="">全部</option>
            @if(isset($paymentType))
                @foreach($paymentType as $index => $item)
                    <option value="{{$index}}"
                            @if(isset($searchCondition['paymentInfo.payment_type']) && $index == $searchCondition['paymentInfo.payment_type']) selected="selected" @endif>{{$item}}</option>
                @endforeach
            @endif
        </select>

    </div>
</div>

3. 在YourModelRepositoryEloquent.php (如FlashRepositoryEloquent.php) 中添加 $fieldSearchable 字段

如：

protected $fieldSearchable = [
    'paymentInfo.payment_type'
];

要与模板文件的name一致。