一、部署安装:
本案例采用32位wampserver3.0.6讲解
(1)、wampserver安装:
简介:它是一款一键搭建apache服务器的php开发工具包,内含32位和64位两个版本,集成了Apache、Mysql、PHP、PhpMyadmin、sqlbuddy、XDebug等服务器组件,能够快速帮助用户搭建apache服务器。
安装:请通过提示进行安装,安装好后启动可能会报某补丁不存在或出错,请根据提示把该补丁重新安装
(2)、下载showdoc:
简介:showdoc是一个非常适合IT团队的在线API文档、技术文档工具。你可以使用Showdoc来编写在线API文档、技术文档、数据字典、在线手册。
地址:http://www.downza.cn/soft/278513.htm
(3)、wampserver与showdoc的整合:
整合:解压showdoc,对解压后的showdoc可以从新命名。之后把该包拷贝到已安装的wampserver的www目录下,如图:
启动:启动wampserver,之后访问http://IP本机/showdoc/index.php?s=/home/update/db如果出现ok,证明服务器迁移成功
(4)、配置自动api生成:
下载安装Git:https://git-scm.com/download/win
下载脚本:https://www.showdoc.cc/script/showdoc_api.sh
下载测试案例:https://www.showdoc.cc/script/api_demo.test
构建项目:启动wampserver,访问http://本机IP地址/showdoc/web/#/item/index 登陆账户密码默认为:showdoc/123456 。登陆后新建测试项目,在项目的设置里面生成api的key和tocken如图:
配置脚本:打开下载好的showdoc_api.sh,把对应的key,tocken填进去,以及填写好本机服务器地址,如图:
自动生成api: 把脚本showdoc_api.sh,api_demo.test 放到一个文件夹里面,通过Git的Git Bash来启动showdoc_api.sh就可以自动生成api_demo.test 的api文档了,如果是项目,那么请把api_demo.test 放到项目目录下,生成的就是项目的api接口文档,如图:
二、报错记录:
(1)、报错10103:
简介:该错误在网上无法找到,其实就是该电脑登陆用户对/Application/Runtime 、 /Public/Uploads 、 /Sqlite 、 /Sqlite/showdoc.db.php 的操作权限没有,你可以通过在文件夹的右键—>属性—>安全里面去给该文件设置修改权限。
另外还需要在php.ini里面把”extension=php_sqlite.dll”和”extension=php_pdo_sqlite.dll”启用以便开启对SQlite的支持;还需启用extension=php_mbstring.dll,对此通过Git的Git Bash来运行showdoc_api.sh脚本就能成功生成api了