用swagger-php/ui做API测试

阅读更多

功能：
1 swagger-php根据自定义的规则生成API请求规则，通过phar生成json文件
2 打开swagger-ui/dist/index.html。输入json文件夹目录地址（需要同源），swagger-ui会根据请求的JSON生成API，页面很漂亮。输入请求参数后执行会获取返回值。
缺点：不能对返回的数据进行验证。功能类似chrome的插件postman。
Api Action测试参考代码：
Resource/PostAction.php

 
 
项目描述信息 
 
Info/api.php 
 
 
 
 
 
readme 
 
 
 
# Usage of API Docs
### Raw Spec Structure
* Info - General Info.
* Model - Entity Class
* Resource - API endpoint

### Compile API info.
* after modify the spec, run shell script, as follows.

	`cd api-docs`
	
	`./genDocumentation.sh`

* the compiled content (.json) is stored in documentation/Output/

### View API docs
* visit http://{domain}/documenation/
 
 
 
 
sh 执行文件 
 
 
 
#!/bin/sh
../swagger-php/swagger.phar ../output-docs -o ../documentation/output/