# dc_base

**Repository Path**: southcnwx/dc_base

## Basic Information

- **Project Name**: dc_base
- **Description**: Laravel5.8 基础代码
- **Primary Language**: PHP
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2019-03-29
- **Last Updated**: 2020-12-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

**关于配置文件**

> 数据库连接的是MongoDB, 由于MongoDB的权限问题, 务必设置账号密码

```
PRIVATE_APP_NAME=在用户中心注册的应用名
PRIVATE_APP_TICKET=应用ticket
APP_ID=在用户中心注册的应用ID

USERCENTER_URL=用户中心URL
USERCENTER_LOGIN_URL=单点登录地址, 但带上oauth_client_app，以便登陆后重定向
USERCENTER_IPS=用户中心IP地址, 多个用|分隔
```
> 以栏目Channel作为范例，控制器参考App\Http\Controllers\Api\ChannelsController。

**1. 获取用户信息**

`GET /api/user/info`

**2. 登录, 该接口仅限于测试使用**

`GET /api/analogin`

| 参数 | 类型 | 必选 | 说明 |
|:-:|:-:|:-:|:-:|
| uid | uuid | 是 | 用户id |

**3. 子应用主动登出**

> 子应用登出会注销当前用户在该应用下的session, 并且调用用户中心的注销回调接口, 从而使用户中心注销全部已授权登陆过的子应用;

`POST /logout`

**4. 用户中心注销子应用回调接口**

> 用户中心调用子应用的注销回调接口, 从而实现同步注销;

`POST /uc/logout`

**5. 用户中心登陆子应用回调接口**

> 用户中心调用子应用的登陆回调接口, 从而实现同步登陆;

`GET /uc/logined`


**关于接口输出格式**

```
// 成功输出时, errcode == 0, 有效载荷在data里; 异常时, errcode != 0, 错误信息在errmessage里;
{
  "errcode": 0,
  "errmessage": "ok",
  "data": {},     // 可以是对象或对象数组
  "trigger": "none",
}
```

**关于常用参数命名规范**

| 参数 | 解释 |
| :-- | :-- |
| page | 页码, 默认为1 |
| size | 条数, 默认为10 |
| keyword | 如果需要搜索参数, 用keyword |

**关于应用间接口调用**

```



```


**关于前端构建**

> 子应用的首页, `/index` 或 `/`, 子应用的登陆页`/login`;

> 前端统一使用vue框架, 单页面应用模式; 目录在`resources/frontend/`下;


**laravel操作mongodb测试**

新增 `curl -XPATCH -H "content-type: application/json" -d '{"name": "make fun", "level": 1, "parent": 0, "status": 1}' http://localhost:8000/api/category`

更新 `curl -XPOST -H "content-type: application/json" -d '{"name": "fun it", "level": 1, "parent": 0, "status": 1}'  http://localhost:8000/api/category/5c97471bcc91006f65743bc4`

删除 `curl -XDELETE http://localhost:8000/api/category/5c976089cc91006f65743bc8`

列表 `curl -XGET http://localhost:8000/api/category`

详情 `curl -XGET http://localhost:8000/api/category/5c97471bcc91006f65743bc4`


**关于路由设置建议**

> 对于需要校验权限的路由, 务必设置路由名;