TRR 立志作最簡單、易上手、易擴展、易維護的TP反射註釋路由架構

時間 2019-12-08

原文原文鏈接

TRR

簡介

TRR 開源地址

TRR 是什麼？

TRR 是ThinkPHP51 Reflection Restful API（注：API設計風格）的字母第一個字符大寫後拼接而來，從ThinkPHP51 Reflection Restful API全稱能夠看出來，這套接口框架設計主要圍繞反射來作Restful API接口設計的。php

TRR 能夠作什麼？

你能夠先了解一下ThinkPHP5.1能作什麼。
ThinkPHP5.1 能作的都能作，並且在反射路由方面，咱們比ThinkPHP5.1更爲專一

專一作什麼:laravel

反射 API 接口路由
反射 API 接口文檔生成
反射 API 參數快速驗證
讓接口開發更簡單、直觀、迅捷
讓接口維護更輕鬆、明瞭、快速

咱們專一研究PHP反射相關的知識點，想讓PHP web功能開發、接口開發更加簡單、迅捷。git

想讓更多的朋友更加專一於業務開發，再也不反覆去作路由添加、修改，接口文檔編寫等一些列的問題github

咱們只想你的項目更快、更穩定、更以維護的成型。web

使用須知

在使用TRR時一定會用到的技能，你得作一個評估，查看本身是否能夠無障礙使用。thinkphp

涉及技術或框架

PHP7.1 一種支持熱編譯的腳本語言json

你須要熟練掌握PHP7.1相關知識點，若是你精通此技能那就再好不過了，不精通也不要緊，請根據我收集的教程和資料進行學習segmentfault
- PHP 官方文檔: php.net/manual/zh/
- 【極客學院】PHP全套教學視頻: www.bilibili.com/video/av102…
- 韓順平php從入門到精通: pan.baidu.com/s/1YDQoLody… 提取碼: 6hyy
ThinkPHP5.1 ：中國比較流行且會一直流行的PHP框架api

若是你對ThinkPHP5.1不太瞭解，或者只知其一;不知其二，請到官方文檔進行查閱，補充效果知識點。官方文檔瀏覽器
Reflection PHP 反射機制

若是你對 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();
      }
 }

複製代碼