TRR
简介
TRR 开源地址
- Github: github.com/china-wangy…
- Gitee: gitee.com/china_wangy…
- 博客：china-wangyu.github.io/
TRR 是什么？
TRR 是ThinkPHP51 Reflection Restful API（注：API设计风格） 的字母第一个字符大写后拼接而来，
从ThinkPHP51 Reflection Restful API全称可以看出来，
这套接口框架设计主要围绕反射来做Restful API接口设计的。
TRR 可以做什么？
- 你可以先了解一下
ThinkPHP5.1能做什么。 -
ThinkPHP5.1能做的都能做，而且在反射路由方面，我们比ThinkPHP5.1更为专注
专注做什么:
- 反射 API 接口路由
- 反射 API 接口文档生成
- 反射 API 参数快速验证
- 让接口开发更简单、直观、迅捷
- 让接口维护更轻松、明了、快速
我们专注研究PHP反射相关的知识点，想让PHP web功能开发、接口开发更加简单、迅捷。
想让更多的朋友更加专注于业务开发，不再反复去做路由添加、修改，接口文档编写等一些列的问题
我们只想你的项目更快、更稳定、更以维护的成型。
使用须知
在使用TRR时必定会用到的技能，你得做一个评估，查看自己是否可以无障碍使用。
涉及技术或框架
-
PHP7.1一种支持热编译的脚本语言你需要熟练掌握
PHP7.1相关知识点，如果你精通此技能那就再好不过了，不精通也没关系，请根据我收集的教程和资料进行学习-
PHP官方文档: php.net/manual/zh/ - 【极客学院】PHP全套教学视频: www.bilibili.com/video/av102…
- 韩顺平php从入门到精通: pan.baidu.com/s/1YDQoLody… 提取码: 6hyy
-
-
ThinkPHP5.1：中国比较流行且会一直流行的PHP框架如果你对
ThinkPHP5.1不太了解，或者一知半解，请到官方文档进行查阅，补充效果知识点。 官方文档 -
ReflectionPHP 反射机制如果你对 PHP 反射相关知识点不是很了解，推荐先进行了解一下
-
PHP官方文档: php.net/manual/zh/b… -
ThinkPHP5.1反射相关知识点: www.kancloud.cn/manual/thin… -
wangyu/reflex-core composer扩展使用: github.com/china-wangy…
-
-
Restful API是一种API接口设计风格或者说潮流如果你对
Restful API还不了解，我收集了一些比较好的译文。-
RESTful架构风格概述: juejin.im/entry/57c7a…-
Restful API PHP的学习视频: www.imooc.com/learn/811
-
-
Composer是php最为流行和使用最多的第三方扩展库推荐使用 阿里云
composer镜像源 1分钟内快速同步，稳定可靠如果你对
Composer了解不够，请仔细阅读我收集的一些资料。-
composer入门中文文档: docs.phpcomposer.com/ -
composer安装文档: packagist.laravel-china.org/ -
composer更换国内源: segmentfault.com/a/119000001…
-
到此，相信你对TRR有了一定的了解了，对TRR项目需要用到的技术有个清晰的了解，如果你还是不太清楚，请继续在网上寻找资源学习吧， 加油，明天会更美丽。
快速开始
在你项目文件夹内,点击鼠标右键 打开 git Bash Here
在 git bash 命令行里使用以下命令
1. 检查服务端必备环境
- 安装
PHP环境(version:7.1及以上) - 安装
Git环境(version:1.8及以上) - 安装
Composer环境(version:1.8及以上)
2. 获取项目源码
获取项目源码
git clone https://github.com/china-wangyu/TRR.git
复制代码在进入项目目录
cd TRR
复制代码3. 安装项目依赖
安装依赖
composer install
复制代码4. 运行项目
为了防止PHP各种集成和非集成软件环境问题，本项目开发期间希望各位使用 ThinkPHP5.1内置服务
有关文档: www.kancloud.cn/manual/thin…
php think run -H 127.0.0.1 -p 8000
复制代码效果如下，就代表你启动内置服务成功了
# F:\project\open-source-object\Trr\2019-7-6\TRR [master +0 ~217 -0 !]
# λ php think run -H 127.0.0.1 -p 8000
# ThinkPHP Development server is started On <http://127.0.0.1:8000/>
# You can exit with `CTRL-C`
# Document root is: F:\project\open-source-object\Trr\2019-7-6\TRR\public
复制代码5. 浏览器访问
访问地址: http://127.0.0.1:8000/
其他功能
创建 JWT 的 Token
route: http://127.0.0.1:8000/auth?name=trr&password=trr
method: post
返回效果：
{
"access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJUUlIiLCJpYXQiOjE1NjI0MDk2MDgsImV4cCI6MTU2MjQxNjgwOCwidXVpZCI6MTAwLCJzaWduYXR1cmUiOiJ0cnIifQ.MXXGcK2xjAznzcC-PQ66dRAo30Wn1poNLCNbFcO7ORA",
"refresh_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJUUlIiLCJpYXQiOjE1NjI0MDk2MDgsInV1aWQiOjEwMCwic2lnbmF0dXJlIjoidHJyIn0.RBs5iOSTjC89Z6H4CPl9tNyXHOhtmuPQPd7JOB_n5JY"
}
复制代码刷新 JWT 的 Token
route: http://127.0.0.1:8000/auth/refresh
method: get
header: 需要设置：authorization
返回效果：
{
"access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJUUlIiLCJpYXQiOjE1NjI0MTE0OTMsImV4cCI6MTU2MjQxODY5MywidXVpZCI6MTAwLCJzaWduYXR1cmUiOiJ0cnIifQ.4siwrzghm-r_SZNz-SUwkI3Of-9Hx9vOHMYdHXjf7rA"
}
复制代码生成 markdown 格式的 API 文档
-
命令行生成
在项目根目录下打开
cmd或终端输入以下命令php think trr:build 复制代码效果如下，代表文档生成成功：
F:\project\open-source-object\Trr\2019-7-6\TRR [master ≡ +0 ~217 -0 !] λ php think trr:build Successful. Output Document Successful . File Path ：api-md.md 复制代码 -
使用
WangYu/Doc类生成文档实现代码如下：
<?php namespace app\index\controller; class Index { // 创建 API Markdown 文档 public function build() { $doc = new \WangYu\Doc('api 模块','生成的API文档名称'); $doc->execute(); } } 复制代码访问
Index类下的build方法，就会在项目根目录创建你的API文档了
维护与提问
更新
由于目前TRR目前还处在不断迭代更新阶段，TP5.1版本也在持续跟进，所以本课程的内容也会随着适配的进度而增加或者调整。
完善
局限于个人技术水平和写作能力，如果教程中有哪些地方读者觉得不对或者看不懂需要再讲仔细些可以随时提出。
催更、提问
读者对本教程或者GitHub项目有任何疑问、建议都可以在作者GitHub仓库提个issues
交流
加【TRR 官方群】QQ群: 860613750
请我喝茶
如果你觉得本项目帮助到你，想请作者喝杯茶 , 请扫码打赏任意金额
版权信息
TRR 遵循 MIT 开源协议发布，并提供免费使用。
本项目包含的第三方源码和二进制文件之版权信息另行标注。
版权所有Copyright © 2006-2019 by TRR
All rights reserved。