laravel 开发辅助工具

摘要：按照最初提出者的介绍，是衔接数据映射层和领域层之间的一个纽带，作用相当于一个在内存中的域对象集合。客户端对象把查询的一些实体进行组合，并把它们提交给。同时支持登录过期时间设置，登录之前，登录之后事件处理。

将下面这行添加至 config/app.php 文件 providers 数组中：

"providers" => [
  ...
  AppPluginsAuthProvidersLaravelServiceProvider::class
 ]

redisToken认证

Repository 模式

表单搜索辅助插件

Excels导出辅助插件

Sign 加签

Sql 写进日志-事件

Controller Traits

首先需要声明的是设计模式和使用的框架以及语言是无关的，关键是要理解设计模式背后的原则，这样才能不管你用的是什么技术，都能够在实践中实现相应的设计模式。

按照最初提出者的介绍，Repository 是衔接数据映射层和领域层之间的一个纽带，作用相当于一个在内存中的域对象集合。客户端对象把查询的一些实体进行组合，并把它 们提交给 Repository。对象能够从 Repository 中移除或者添加，就好比这些对象在一个 Collection 对象上进行数据操作，同时映射层的代码会对应的从数据库中取出相应的数据。

从概念上讲，Repository 是把一个数据存储区的数据给封装成对象的集合并提供了对这些集合的操作。

Repository 模式将业务逻辑和数据访问分离开，两者之间通过 Repository 接口进行通信，通俗点说，可以把 Repository 看做仓库管理员，我们要从仓库取东西（业务逻辑），只需要找管理员要就是了（Repository），不需要自己去找（数据访问），具体流程如下图所示：

php artisan make:repo User

php artisan make:repo User --cache

创建 UserRepository 时会询问是否创建Model ，如果Model以存在，需要把 AppRepositoriesModulesUserProvider::class 的Model替换成当前使用的Model

将下面这行添加至 AppProvidersAppServiceProvider::class 文件 register 方法中：

public function register()
{
    $this->app->register(AppRepositoriesModulesUserProvider::class);
}

repo = $repo;
    }

    public function index(Request $request){
        return $this->respondWithSuccess($this->repo->get(["*"]));
    }
}

配合 Search 更灵活

public function index(Request $request){
        return $this->respondWithSuccess(
            $this->repo->getwhere(
                new IndexSearch($request->olny(["name"])) ,
                ["*"]
            )
        );
    }

参考 Repository 方法

把表单提交的一些参数传换成 where 语句.

生成一个UserController::index控制器使用的搜索辅助类

php artisan make:search UserIndexSearch

上面命令会创建一个 AppSearchsModulesUserIndexSearch::class 的类

创建Search时，建议根据 ControllerActionSearch 的格式创建。

 "=",
        "name"  => "like",
        "date" => "between"
    ];
        
    public function getNameAttribute($value)
    {
        return $value . "%";
    }
    
    public function getDateAttribute($value){
        return function ($query){
            $query->where("date", ">", "2018-05-05")->where("status", 1);
        };
    }
}

repo = $repo;
    }

    public function index(Request $request){
        return $this->respondWithSuccess(
            $this->repo->getWhere(
                new IndexSearch(
                    $request->only(["phone", "name", "date"])
                ), 
                ["*"]
            )
          );
    }
}

请求参数：

phone=18565215214&name=成龙&date=2018-08-21

生成的sql

WHERE (phone = 18565215214) AND (name like "成龙%") AND (date > "2018-05-05" AND status = 1)

Excels导出辅助插件

php artisan make:excel User

上面命令会创建一个 AppExcelsModulesUserExcel::class 的类

id,
            $this->phone,
            $this->name
        ];
    }


    /**
     * 搜索参数
     * @return {[type]} [description]
     */
    protected function getAttributes()
    {
        return new ExcelSearch(request()->only([
            "phone",
            "name",
        ]));
    }


}

更多用法 请参考 maatwebsite/excel

把sql语句记录到日志里

在 laravel 自带的 EventServiceProvider 类里 listen 添加

 "IlluminateDatabaseEvents" => [
    "luffyzhaolaravelToolsListenersQueryListeners"
 ]

php artisan event:generate

controller公用方法

在 AppHttpControllersController 类中 use luffyzhaolaravelToolsTraitsResponseTrait

请求参数加签验证

如果你使用的是md5加签方式请在config/app.php文件中，添加 sign_key 配置。如果你使用的是Rsa加签方式请在config/app.php文件中，添加app.sign_rsa_private_key和app.sign_rsa_public_key配置

在app/Http/Kernel.php文件中，您需要把 "sign" => luffyzhaolaravelToolsMiddlewareVerifySign::class, 添加到$routeMiddleware属性中

 "sign:api"],
    function($route){
        Route::get("xxx", "xxx");
    }
);

加签方式

rsa 和 md5

参数排序

准备参数

添加 timestamp 字段

然后按照字段名的 ASCII 码从小到大排序（字典序）

生成 url 参数串

拼接 key 然后 md5 或者 rsa

如下所示：

{
    "name": "4sd65f4asd5f4as5df",
    "aimncm": "54854185",
    "df4": ["dfadsf"],
    "dfsd3": {
        "a": {
            "gfdfsg": "56fdg",
            "afdfsg": "56fdg"
        }
    }
}

排序后：

{
    "aimncm": "54854185",
    "df4": ["dfadsf"],
    "dfsd3": {
        "a": {
            "afdfsg": "56fdg",
            "gfdfsg": "56fdg"
        }
    },
    "name": "4sd65f4asd5f4as5df",
    "timestamp": "2018-05-29 17:25:34"
}

生成url参数串：

aimncm=54854185&df4[0]=dfadsf&dfsd3a=56fdg&dfsd3a=56fdg&name=4sd65f4asd5f4as5df×tamp=2018-05-29 17:25:34

拼接 key :

aimncm=54854185&df4[0]=dfadsf&dfsd3a=56fdg&dfsd3a=56fdg&name=4sd65f4asd5f4as5df×tamp=2018-05-29 17:25:34base64:Z9I7IMHdO+T9qD3pS492GWNxNkzCxinuI+ih4xC4dWY=

md5加密

ddab78e7edfe56594e2776d892589a9c

把token保存在redis。同时支持登录过期时间设置，登录之前，登录之后事件处理。

在 config/auth.php 文件中，你需要将 guards/driver 更新为 redis-token：

"defaults" => [
    "guard" => "api",
    "passwords" => "users",
],

...

"guards" => [
    "api" => [
        "driver" => "redis-token",
        "provider" => "users",
    ],
],

如果需要使用 redis-token 作为用户认证，我们需要对我们的 User 模型进行一点小小的改变，实现一个接口，变更后的 User 模型如下：

getKey();
    }
}

  /**
       * 登录
       * @method store
       * @param StoreRequest $request
       *
       * @return IlluminateHttpJsonResponse
       *
       * @author luffyzhao@vip.126.com
       */
      public function store(StoreRequest $request)
      {
          $token = auth("api")->attempt(
              $request->only(["phone", "password"])
          );
          
          if (!$token) {
              return $this->respondWithError("用户不存在,或者密码不正确！");
          }
          
          return $this->respondWithToken((string) $token);
      }

/**
     * 退出登录.
     *
     * @method logout
     *
     * @return IlluminateHttpJsonResponse
     *
     * @author luffyzhao@vip.126.com
     */
    public function logout()
    {
        auth("api")->logout();

        return $this->respondWithSuccess([], "退出成功");
    }

方法

方法