Auteur
zsw zswemail@qqcomPage d'accueil https : //zsw.ink
github https://github.com/iszsw/mock
gitee https://gitee.com/iszsw/mock
Utilisez
1. Installez
composer require iszsw/mock:dev-master
2. Ajoutez le code de test et ajoutez le fichier Test.php dans le répertoire app/controller
<?php namespace app\controller; use app\BaseController; use iszsw\mock\annotation\illustrate\AutoValidate; use iszsw\mock\annotation\illustrate\Route; use iszsw\mock\annotation\illustrate\Mock; use iszsw\mock\annotation\illustrate\MockPack; use iszsw\mock\annotation\illustrate\WikiItem; use iszsw\mock\annotation\illustrate\WikiMenu; /** * @WikiMenu("测试") * @package app\controller * Author: zsw zswemail@qq.com */ class Test extends BaseController { /** * @Route("test", method="GET") * @WikiItem("首页", description="首页详情") * * @AutoValidate({"username":"require|chsAlpha"}, message={"username":"请输入用户名"}) * @Mock("username", mode="request", title="用户名", example="name") * @Mock("name", mode="response", title="名字", example="name", description="文章ID") */ public function index($username){ return "hello " . $username; } /** * @Route("mock", method="GET") * @WikiItem("详情", description="文章详情") * * @Mock("id", title="ID", example="numberBetween", description="文章ID") * @MockPack("articles", mode="response", title="文章列表", description="文章列表", limit=5) * @Mock("id", mode="response", title="ID", example="randomDigitNotNull", description="文章ID") * @Mock("title", mode="response", title="标题", example="name") * @Mock("create_time", mode="response", title="创建时间", example={"date": {"Y-m-d", "now"}}) * @Mock("content", mode="response", title="内容", example={"sentence": 10}) * @Mock("image", mode="response", title="图片", example="randomDigit") * @MockPack("user", main=true, mode="response", title="用户", description="发布者信息", limit=0) * @Mock("username", mode="response", title="用户名", example="name") * @MockPack("user") * @MockPack("articles") * @Mock("page", mode="response", title="页码", example="randomDigitNotNull", description="当前页码") */ public function mock(){} }
. 3. Copiez le dossier du fichier de ressources du document supplier/iszsw/mock/src/static et placez-le sous public
<br>如果路径不不是 /static 可以在config/mock.php配置文件中修改
4 Visitez
注解路由:/test?username=zsw 测试数据:/mock?mock=1 接口文档:/wiki
Description de la fonction
Configuration du fichier. /mock.php
1. Routage d'annotation
L'injection automatique d'annotation de modèle d'annotation d'itinéraire est la même que l'annotation officielle Tp6Nouvelle annotation de validation automatique
@AutoValidate({"username":"require|chsAlpha"}, message={"username":"请输入用户名"})
2. .Génération de données de test d'interface
La génération de données imbriquées MockPack prend en charge l'imbrication illimitée
@MockPack extends MockBase // 数据长度 0表示单层数据 @var int limit /* * 置顶 (limit > 1 时有效) * false:['fields'=>[["a"=>"b"], ["aa"=>"bb"]]] * true:[["a"=>"b"], ["aa"=>"bb"]] */ @var boolean main
Exemple :
/** * @MockPack("articles", mode="response", title="文章列表", description="文章列表", limit=3) * @Mock("title", mode="response", title="标题", example="name") * @Mock("content", mode="response", title="内容", example={"sentence": 10}) * * @MockPack("user", main=true, mode="response", title="用户", description="发布者信息", limit=0) * @Mock("username", mode="response", title="用户名", example="name") * @MockPack("user") * * @MockPack("articles") */ 生成结果 { "articles": [{ "title": "乔阳", "content": "Vero impedit et consequatur quasi doloribus dolores illum sit expedita doloremque fugiat esse deleniti quisquam.", "user": { "username": "方建明" } }, { "title": "蒙桂花", "content": "Iure explicabo officiis minima et impedit sunt dignissimos necessitatibus ratione animi nam aperiam dolorum.", "user": { "username": "谷致远" } }, { "title": "郑文", "content": "Minus cum unde exercitationem sunt laudantium eveniet voluptatem magni ut cum non.", "user": { "username": "宁丽娟" } }] }
Génération de données simulées
@Mock extends MockBase /** * 自定义字符串 example="zsw" * Faker方法名 参考https://github.com/fzaninotto/Faker * 自定义方法名 \app\logic\Mock::name * example="方法名" || example={"方法名": {"参数1", "参数2"}} */ @var string|array example
3. 🎜> <?php /**
* @WikiMenu("测试")
*/
class Test extends BaseController
{
/**
* @Route("test", method="GET")
* @WikiItem("首页", description="首页详情")
* @Mock("name", mode="response", title="名字", example="name", description="名字")
*/
public function index(){
return "zsw";
}
}
Copier après la connexion
Référence d'utilisation1. Routage des annotations2. Génération de données de test d'interface<?php /** * @WikiMenu("测试") */ class Test extends BaseController { /** * @Route("test", method="GET") * @WikiItem("首页", description="首页详情") * @Mock("name", mode="response", title="名字", example="name", description="名字") */ public function index(){ return "zsw"; } }
<?php namespace app\controller;
use app\BaseController;
use iszsw\mock\annotation\illustrate\Route;
use iszsw\mock\annotation\illustrate\Mock;
use iszsw\mock\annotation\illustrate\MockPack;
use iszsw\mock\annotation\illustrate\WikiItem;
use iszsw\mock\annotation\illustrate\WikiMenu;
/**
* @WikiMenu("测试")
*/
class Test extends BaseController
{
/**
* @Route("mock", method="GET")
* @WikiItem("详情", description="文章详情")
* @Mock("id", title="ID", example="numberBetween", description="文章ID")
*
* @MockPack("articles", mode="response", title="文章列表", description="文章列表", limit=3)
* @Mock("title", mode="response", title="标题", example="name")
* @Mock("content", mode="response", title="内容", example={"sentence": 10})
*
* @MockPack("user", main=true, mode="response", title="用户", description="发布者信息", limit=0)
* @Mock("username", mode="response", title="用户名", example="name")
* @MockPack("user")
*
* @MockPack("articles")
*/
public function mock(){}
}
Copier après la connexion
Le format des données générées est <?php namespace app\controller; use app\BaseController; use iszsw\mock\annotation\illustrate\Route; use iszsw\mock\annotation\illustrate\Mock; use iszsw\mock\annotation\illustrate\MockPack; use iszsw\mock\annotation\illustrate\WikiItem; use iszsw\mock\annotation\illustrate\WikiMenu; /** * @WikiMenu("测试") */ class Test extends BaseController { /** * @Route("mock", method="GET") * @WikiItem("详情", description="文章详情") * @Mock("id", title="ID", example="numberBetween", description="文章ID") * * @MockPack("articles", mode="response", title="文章列表", description="文章列表", limit=3) * @Mock("title", mode="response", title="标题", example="name") * @Mock("content", mode="response", title="内容", example={"sentence": 10}) * * @MockPack("user", main=true, mode="response", title="用户", description="发布者信息", limit=0) * @Mock("username", mode="response", title="用户名", example="name") * @MockPack("user") * * @MockPack("articles") */ public function mock(){} }
{ "articles": [{ "title": "乔阳", "content": "Vero impedit et consequatur quasi doloribus dolores illum sit expedita doloremque fugiat esse deleniti quisquam.", "user": { "username": "方建明" } }, { "title": "蒙桂花", "content": "Iure explicabo officiis minima et impedit sunt dignissimos necessitatibus ratione animi nam aperiam dolorum.", "user": { "username": "谷致远" } }, { "title": "郑文", "content": "Minus cum unde exercitationem sunt laudantium eveniet voluptatem magni ut cum non.", "user": { "username": "宁丽娟" } }] }
<?php namespace app\controller;
use iszsw\mock\annotation\illustrate\Route;
use iszsw\mock\annotation\illustrate\WikiItem;
use iszsw\mock\annotation\illustrate\WikiMenu;
/**
* @WikiMenu("测试")
*/
class Test
{
/**
* @Route("test", method="GET")
* @WikiItem("首页", description="首页详情")
* @Mock("username", mode="request", title="用户名", example="name")
* @Mock("name", mode="response", title="名字", example={"\app\controller\Mock::name": {100}}, description="文章ID")
*/
public function index($username){}
}
Copier après la connexion
<?php namespace app\controller; use iszsw\mock\annotation\illustrate\Route; use iszsw\mock\annotation\illustrate\WikiItem; use iszsw\mock\annotation\illustrate\WikiMenu; /** * @WikiMenu("测试") */ class Test { /** * @Route("test", method="GET") * @WikiItem("首页", description="首页详情") * @Mock("username", mode="request", title="用户名", example="name") * @Mock("name", mode="response", title="名字", example={"\app\controller\Mock::name": {100}}, description="文章ID") */ public function index($username){} }