showdoc在win下自動生成api所踩過的坑

一、部署安裝:

              本案例採用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.shapi_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了

                     

 

 

 

 

 

 

 

 

 

 

 

 

 

 

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章