crmeb多商户二开接口流程文档【1】

流程

主要讲解controller目录，每个controller有自己独立的路由，配置，事件，容器，控制器中可用框架核心及扩展。每个控制器其实就是一个独立的控制类。

请求流程大致分为以下流程,依次从左到右

Middleware

中间件分为前置和后置中间件.

前置中间件在访问控制器之前会被执行调用,通常用来拦截参数,跨域配置,多语言加载,Session初始化,权限验证,登陆验证等处理;

而后置中间件属于返回数据后在执行的中间件,用来做一些返回数据后需要执行的任务等业务逻辑

下面以前置中间件为例:文件存放目录 app/应用名/middleware/AuthMiddleware.php

1. <?php
3. namespase app\应用名\middleware;
5. use crmeb\interfaces\MiddlewareInterface;
7. class AuthMiddleware implements MiddlewareInterface
8. {
9. public function handle(Request $request, \Closure $next)
10. {
11. //这里可以设置请求header
12. //可以写权限验证
13. //验证失败直接可以抛出异常中止请求
14. if(false)
15. {
16. throw new AuthException('无权验证');
17. }
18. return $next($request);
19. }
20. }

Controller

每个控制器负责相关业务的请求接收，只做最基本的数据接收，并调用相关的sevices业务处理层，返回数据。
例如：

1. <?php
2. namespace app\controller;
4. use app\Request;
6. use app\common\repositories\user\UserRepository;
8. class User
9. {
10. protected $repository;
11. public function __construct(App $app, repository $repository)
12. {
13. parent::__construct($app);
14. $this->repository = $repository;
15. }
17. public function lst($cid)
18. {
19. [$page, $limit] = $this->getPage();
20. $where = $this->request->params(['id']);
21. $data = $this->repository->search($where, $page, $limit);
22. return app('json')->success($data);
23. }
24. }

---

Repository

所有的业务都在Repository层中处理，Repository层调用dao层，【注意：每个独立的services层只能调用对应的dao层，不能调用其他模型dao层。
比如：repository/user/UserRepository.php中只能调用dao/user/UserDao.php，无法调用 dao/order/StoreOrderDao.php。要想调用其他模型数据，
只能在UserServices.php中调用services/order/StoreOrderServices.php的方法来实现其他模型数据调用】。
例如：

1. <?php
2. namespace app\common\repositories\user;
4. use app\common\dao\user\UserDao;
6. class UserRepository extends BaseRepository
7. {
8. protected $dao;
9. public function __construct(UserDao $dao)
10. {
11. $this->dao = $dao;
12. }
14. public function search(array $where, int $page, int $limit)
15. {
16. $list = $this->dao->getList($where,'*',$page,$limit);
17. $count = $this->dao->count($where);
18. return compact('count','list');
19. }
21. }

---

Dao

dao层中主要用于当前模型基本的数据处理方法。dao层中调用对应的model,同样无法跨层调用。
例如：

1. <?php
2. namespace app\dao\user;
4. use app\dao\BaseDao;
5. use app\model\user\User;
7. /**
8. * 用户
9. * Class UserDao
10. * @package app\dao\user
11. */
12. class UserDao extends BaseDao
13. {
15. protected function setModel(): string
16. {
17. return User::class;
18. }
21. public function getOne($uid)
22. {
23. return $this->where(['uid' => $uid])->field('username，phone')->find();
24. }
25. }

---

Model

model主要用于实例化数据表，只做相关数据表的基础设置，搜索器，设置器及表关联等操作。

1. <?php
2. namespace app\model\user;
4. use crmeb\basic\BaseModel;
5. use think\Model;
7. /**
8. * Class User
9. * @package app\model\user
10. */
11. class User extends BaseModel
12. {
14. /**
15. * @var string
16. */
17. protected $pk = 'uid';
19. protected $name = 'user';
21. protected $insert = ['add_time', 'add_ip', 'last_time', 'last_ip'];
23. protected $hidden = [
24. 'add_ip', 'account', 'clean_time', 'last_ip', 'pwd'
25. ];
27. /**
28. * 自动转类型
29. * @var string[]
30. */
31. protected $type = [
32. 'birthday' => 'int'
33. ];
35. protected $updateTime = false;
38. /**
39. * 修改器
40. */
41. protected function setAddTimeAttr($value)
42. {
43. return time();
44. }
47. /**
48. * 关联订单
49. * @return User|\think\model\relation\HasMany
50. */
51. public function order()
52. {
53. return $this->hasMany(StoreOrder::class, 'uid', 'uid');
54. }
56. /**
59. /**
60. * 搜索器 用户uid
61. * @param Model $query
62. * @param $value
63. */
64. public function searchUidAttr($query, $value)
65. {
66. if (is_array($value))
67. $query->whereIn('uid', $value);
68. else
69. $query->where('uid', $value);
70. }
73. }