苦逼的程序猿写代码没个需求文档,写完代码还要给前端同事提供接口文档,正所谓己所不欲勿施于人,没有需求文档,咱就要好好写接口文档。为了方便编写和展示,所以在网上找了下接口文档管理工具,在众多工具中选了一个showdoc,感觉他们文档做得很好,教程看上去也比较高大上,其实教程都已经写得很详细了,只是第一次部署php工程还是遇到了点问题,闲话不多说,现在就来记录一下第一次部署php工程的过程(Windows下)。
1.相关地址
showdoc官网:https://www.showdoc.cc/
showdoc部署手册:https://www.showdoc.cc/help?page_id=13732
showdoc代码下载地址:https://github.com/star7th/showdoc
apache官网:http://httpd.apache.org/
PHP下载:http://www.php.net/downloads.php
2.安装Apache
php项目需要Apache服务中启动,在官网下载httpd 2.2.29,解压到指定目录下,根文件下的conf目录下有个httpd.conf文件需要修改SRVROOT地址为Apache的目录
cmd窗口进入bin目录下运行httpd -k install安装服务,安装完成后点击bin目录下ApacheMonitor.exe启动服务,访问localhost出现如下界面说明安装成功
3.安装PHP
下载稳定版php环境,解压到指定文件夹,将根目录下php.ini-development文件复制一份命名为php.ini,按照部署手册中修改php.ini文件。
然后回到httpd.conf文件末尾,加上如下代码:
# php7 support
LoadModule php7_module "D:/Program Files/php-7.1.5-Win32-VC14-x64/php7apache2_4.dll"
AddHandler application/x-httpd-php .php
# configure the path to php.ini
PHPIniDir "D:/Program Files/php-7.1.5-Win32-VC14-x64"
重启Apache,在Apache安装目录的htdocs目录下新建index.php文件,输入如下内容
<?php phpinfo(); ?>然后访问http://localhost/index.php
出现php版本信息说明正常。
4.把下载下的showdoc文件夹拷贝到Apache的htdocs下,即可根据路径访问showdoc了。
以上就部署了一个PHP开发的接口文档管理工具,本人对PHP一窍不通,看着各路大神的博客就摸索出了这么一条路,记录一下以便不时之需。