同步操作将从 嗝嗝/TP5.1 Restful Api 强制同步,此操作会覆盖自 Fork 仓库以来所做的任何修改,且无法恢复!!!
确定后同步将在后台操作,完成时将刷新页面,请耐心等待。
PHP7.2 + TP5.1 + Restful Api ,构建的API项目架构,支持API文档输出、API接口自检、开启API JWT模式、反射路由模式、API参数自检等功能
为了本项目拥有更加直白与客观的简易性、阅读性、实用性,所用的扩展和第三方代码,均未考虑高度抽象和深度封装,各位大大可以很简单的看懂源码和框架设计。
如果有需要或涉及到高并发的服务架构,可以在issues提出,或者留言也行,我将参考大家的意愿,出一个版本或demo。
软件架构说明
www WEB部署目录(或者子目录)
├─application 应用目录
│ ├─api 接口模块目录(可以更改,但不建议:很麻烦,模块里面不建议写模型和视图)
│ │ ├─common.php 模块函数文件(接口函数推荐写在这里)
│ │ ├─controller 控制器目录
│ │ │ ├─v1 接口版本模块
│ │ │ ├─v... 接口版本模块
│ ├─common 公共模块目录(可以更改)
│ │
│ ├─command.php 命令行定义文件
│ ├─common.php 公共函数文件
│ └─provider.php 应用容器绑定定义
│ └─tags.php 应用行为扩展定义文件
│
├─config 应用配置目录
│ ├─api 模块配置目录
│ │ ├─app.php 应用配置
│ │
│ ├─api.php 接口配置
│ ├─app.php 应用配置
│ ├─cache.php 缓存配置
│ ├─cookie.php Cookie配置
│ ├─database.php 数据库配置
│ ├─log.php 日志配置
│ ├─session.php Session配置
│ ├─template.php 模板引擎配置
│ └─trace.php Trace配置
│
├─route 路由定义目录
│ ├─route.php 路由定义
│ └─... 更多
│
├─public WEB目录(对外访问目录)
│ ├─index.php 入口文件
│ ├─router.php 快速测试文件
│ └─.htaccess 用于apache的重写
│
├─thinkphp 框架系统目录
│ ├─lang 语言文件目录
│ ├─library 框架类库目录
│ │ ├─think Think类库包目录
│ │ └─traits 系统Trait目录
│ │
│ ├─tpl 系统模板目录
│ ├─base.php 基础定义文件
│ ├─console.php 控制台入口文件
│ ├─convention.php 框架惯例配置文件
│ ├─helper.php 助手函数文件
│ ├─phpunit.xml phpunit配置文件
│ └─start.php 框架入口文件
│
├─extend 扩展类库目录
├─runtime 应用的运行时目录(可写,可定制)
├─vendor 第三方类库目录(Composer依赖库)
├─build.php 自动生成定义文件(参考)
├─composer.json composer 定义文件
├─LICENSE.txt 授权说明文件
├─README.md README 文件
├─think 命令行入口文件
git clone https://gitee.com/china_wangyu/TP5.1-Restful-Api.git
cd TP5.1-Restful-Api
composer
更新项目扩展,提升项目安全性、可用性推荐使用
composer
中国镜像源,具体操作见【文档】
composer install
api.php
与app.php
api.php
目录在 {项目}/config/api.php
app.php
目录在 {项目}/config/api/app.php
route.php
route.php
目录在 {项目}/route/api.php
如果不修改模块,请直接使用默认配置
配置api.php
// 是否开启授权验证
'API_AUTHORIZATION' => true,
修改Base.php
项目基类(不建议修改)
<?php
/**
* Created by User: wene<china_wangyu@aliyun.com> Date: 2019/4/3 Time: 16:36
*/
namespace app\api\controller\v1;
use think\restful\jwt\Jwt;
/**
* Class Reflex API基类
* @package app\api\controller\v1
*/
class Base extends \think\restful\Api
{
/**
* Base constructor. 有什么事要在父类执行之后执行的代码,请写在parent::__construct($debug);下
* @param bool $debug
*/
public function __construct($debug = false)
{
parent::__construct($debug);
}
/**
* 继承父类方法,如果有什么要在最开始执行的,请写在里面
*/
protected function handle()
{
if ($this->config['API_AUTHORIZATION']){
// 开启JWT验证,执行业务代码
if(!isset($this->param['jwt']) or !isset($this->param['signature'])) {
// 没有jwt参数 或 signature 签名
$this->error('400 缺少API授权信息~');
}
$jwtArr = Jwt::decode($this->param['jwt'],$this->config['API_AUTHORIZATION_KEY']);
$userJwtSignature = md5(join(',',$jwtArr['data']));
if ($userJwtSignature !== $this->param['signature']) {
$this->error('400 API授权信息错误~');
}
}
}
}
修改token.php
(不建议修改)
<?php
/**
* Created by User: wene<china_wangyu@aliyun.com> Date: 2019/4/3 Time: 17:34
*/
namespace app\api\controller;
use think\Request;
use think\restful\Base;
use think\restful\jwt\Jwt;
use think\restful\response\Json;
class Token extends Base
{
public function __construct()
{
parent::__construct();
}
public function create()
{
$param = $this->param;
if(empty($param['userName']) or empty($param['userLoginKey'])){
return Json::json(404,'参数userName/userLoginKey不能为空~');
}
$token = $tokenTemplate = $this->config['API_AUTHORIZATION_TOKEN'];
$token['iat'] = time();
$token['nbf'] = $token['iat'] + 10;
$token['exp'] = $token['iat'] + 600;
$token['data'] = ['userName'=>$param['userName'],
'userLoginKey'=>$param['userLoginKey']];
$jwt = Jwt::encode($token,$this->config['API_AUTHORIZATION_KEY']);
return Json::json(200,'操作成功~',[
'jwt'=>$jwt,
'tt'=> $token['iat'],
'exp' => $token['exp'],
'signature' => md5(join(',',$token['data']))
]);
}
/**
* 刷新时长
* @return array
*/
public function reset(){
$param = $this->param;
if(empty($param['jwt']))return Json::json(404,'参数jwt不能为空~');
$jwtArr = Jwt::reset($jwt,$this->config['API_AUTHORIZATION_KEY']);
return Json::json(200,'操作成功~',[
'jwt'=> $jwtArr['jwt'],
'tt'=> $jwtArr['jwt']['iat'],
'exp' => $jwtArr['jwt']['exp'],
'signature' => md5(join(',',$jwtArr['token']['data']))
]);
}
}
auth
文件举例
代码模板
<?php
namespace app\api\controller\v1;
/**
* Class Auth Auth授权类
* @package app\api\controller\v1
*/
class Auth extends Base
{
/**
* @doc 获取服务器授权1
* @route /api/v1/auth get
* @param string $appSecret 授权字符 require|alphaNum 1
* @param string $appSec2t 授权字符1 require|alphaNum 1
* @param string $appId 开发者ID
* @success {"code":400,"msg":"appSecret不能为空","data":[]}
* @error {"code":400,"msg":"appSecret不能为空","data":[]}
*/
public function read()
{
return $this->success('成功~');
}
}
接口类注释说明
/**
* Class Auth Auth授权类
* @package app\api\controller\v1
*/
class Auth extends Base
接口方法注释
/**
* @doc 获取服务器授权1
* @route /api/v1/auth get
* @param string $appSecret 授权字符 require|alphaNum 1
* @param string $appSec2t 授权字符1 require|alphaNum 1
* @param string $appId 开发者ID
* @success {"code":400,"msg":"appSecret不能为空","data":[]}
* @error {"code":400,"msg":"appSecret不能为空","data":[]}
*/
public function read()
{
return $this->success('成功~');
}
接口方法注释参数说明
@ 名称 | 参数1注解 | 参数2注解 | 参数3注解 |
---|---|---|---|
doc | API接口文档 | ||
route | API路由规则 | 请求类型 | |
param | api参数 | 验证规则 | 默认值 |
success | API请求成功返回json示例 | ||
error | API请求失败返回json示例 |
http://127.0.0.1:8000/api/v1/auth?appSecret=12&appSec2t=12
public function read()
{
# $this->param 就是接口请求数据,包含请求版本号,请求接口类名称
return $this->success('成功~',$this->param);
}
{
"responseCode": 200,
"responseMsg": "成功~",
"responseData": {
"appSecret": "12",
"appSec2t": "12",
"version": "v1",
"controller": "auth"
}
}
json
数据注意本函数与
TP
内置think\Controller
的success\errror
同名
状态为200
的 样例
public function read()
{
return $this->success('成功~');
}
{
"responseCode": 200,
"responseMsg": "成功~",
"responseData": {
"appSecret": "12",
"appSec2t": "12",
"version": "v1",
"controller": "auth"
}
}
状态为400
的 样例
public function read()
{
return $this->error('成功~');
}
{
"responseCode": 400,
"responseMsg": "参数错误:appSecret不能为空",
"responseData": []
}
success/error
函数参数说明
参数名称 | 注解 | 类型 | 默认值 |
---|---|---|---|
msg | 接口调用提示 | ||
data | 返回数据 | 请求类型 |
需要设置api.php
的API_AUTHORIZATION
值为false
// 是否开启授权验证
'API_AUTHORIZATION' => false,
打开cmd/ssh
工具
进入项目目录
执行命令
C:\Users\zhns_\Desktop\php\TP5.1-Restful-Api [master ≡ +2 ~223 -1 !]
> php think api:make
API markdown 接口文档地址: C:\Users\zhns_\Desktop\php\TP5.1-Restful-Api\\API接口文档2019-04-16 15.md
需要设置api.php
的API_AUTHORIZATION
值为false
// 是否开启授权验证
'API_AUTHORIZATION' => false,
打开cmd/ssh
工具
进入项目目录
开启接口服务
php -S {IP地址}:{端口} -t {项目目录}/public/
> php think run -H {IP地址} -P {端口}
ThinkPHP Development server is started On <http://127.0.0.1:8000/>
You can exit with `CTRL-C`
Document root is: E:\VirtualBox\vms\CICD\labs\tp5restfulapi_architecture\public
然后配置项目 api.php
配置文件的参数 (可选)
'API_HOST'=> 'http://127.0.0.1:8000',# 设置API网址
如果没有配置这个,请在执行的时候加上-H指定网址
输入自检命令 php think API -C 1
C:\Users\zhns_\Desktop\php\TP5.1-Restful-Api [master ≡ +2 ~223 -1 !]
> php think api:check
API markdown 自检文档地址: C:\Users\zhns_\Desktop\php\TP5.1-Restful-Api\\API自检文档2019-04-16 15.md
php think API -C 1 -H
C:\Users\zhns_\Desktop\php\TP5.1-Restful-Api [master ≡ +2 ~223 -1 !]
> php think api:check -H http://127.0.0.1:8000
API markdown 自检文档地址: C:\Users\zhns_\Desktop\php\TP5.1-Restful-Api\\API自检文档2019-04-16 16.md
详情请点击 【接口示例文档.md】查看效果。
本来想写成json格式的,后面想想还是这个makdown文档最为方便,希望大家喜欢。
本扩展或者说是一个TP5.1+PHP7.2的后端项目API架构, 主要是帮助刚刚入行或者快速建站的朋友们,进行项目快速迭代开发, 把接口授权、接口验证、参数校验、接口文档输出、接口自验包裹封装起来, 只为大家用的安心。
项目开发或者扩展开发,都需要不断地编码尝试与线上环境验证。 所需的资源和时间都是有成本的,如果项目帮助到您了, 如果您有心帮助作者,请点击下方的捐赠按钮
如有疑问,请联系邮箱 china_wangyu@aliyun.com
请联系QQ 354007048 / 354937820
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。