最近做一个项目，前后端交互的api文档一直以excel和word的形式管理，觉得很不方便，于是就是想找个更直观的方式。在网上找了一圈，有一些看起来很不错（没用过，所以只能说看起来很不错）的开源api管理平台，比如EasyAPI。
但是，我又不想将api放在别人的服务器上，继续寻找，发现了showdoc。这是个可以部署到自己服务器的开源api管理项目，使用的php。于是，我开始在自己的mac上折腾Apache+PHP+MySQL，下面进入正题。
mac osx系统都自带了Apache和PHP环境，只是默认情况下没有开启，我个人设备环境如下：
打开终端，输入如下开启命令。
在浏览器中输入localhost，如果出现如下默认的“It works!”界面，则表示Apache开启成功。
localhost-osx-apache.png
开启PHP，需要修改Apache配置文件，方法如下：
mac下Apache的默认文件夹为/Library/WebServer/Documents，在该目录下创建一个名为index.php文件，在文件中添加如下内容：。删除原目录下的index.html文件，然后在浏览器中输入localhost，如果出现如下PHP的info页，则表示PHP开启成功，如果不成功，用前面的命令重启Apache再试。
QQ20160219-0@2x.png
上面说到了mac下Apache的默认文件夹为/Library/WebServer/Documents，该目录默认是隐藏的，操作不是很方便，我们可以将其修改成自定义的目录。
完成以上三步后，重启Apache，将之前创建的index.php文件拷贝到自定义目录中，然后在浏览器中输入localhost，如果出现PHP的info页，则表示目录修改成功。
OSX 10.11没有自带MySQL，需要我们自己安装。这里只介绍最简单的方式，到MySQL官网下载最新的dmg安装包，我本人下载的是mysql-5.7.11-osx10.10-x86_64.dmg。进入下载页面后，会提示你登陆或注册，这里不必理会，直接点击底部的“No thanks, just start my download.”即可开始下载。 双击下载的dmg安装，一直下一步安装，最后安装完成后会弹出一个提示，告诉你MySQL为root@localhost账号生成了一个临时密码，务必将这个密码保存下来。
mysql-root-password.png
QQ20160219-2@2x.png
QQ20160219-1@2x.png
打开终端，输入命令（将temppassword替换为之前保存的临时密码）：/usr/local/mysql/bin/mysqladmin -u root -p'temppassword' password 'newpassword'
如果出现“2002 MySQL Socket error”错误，表示无法找到支持MySQL的c/s通信的socket。原因是MySQL将其放在 /tmp 目录，而OSX将其放在 /var/mysql 目录。所以我们只需要创建一个软链接，输入以下两个命令即可：创建目录：sudo mkdir /var/mysql创建软链接：sudo ln -s /tmp/mysql.sock /var/mysql/mysql.sock
完成以上两步，MySQL就算安装配置完成了，不过为了方便，有必要安装一个可视化的工具，我选择phpMyAdmin。 直接到phpMyAdmin官网下载最新的zip包，建议下载多语言版本，支持简体中文。下载完成后，将解压后的文件夹重命名为phpMyAdmin，然后放置到自定义的Apache路径的根目录下。 在浏览器中输入localhost/phpMyAdmin，出现MySQL的登陆页面，在该页面可以设置语言，然后用root和之前设置的密码登陆。看到如下两个页面，就大功告成了！！
QQ20160219-3@2x.png
QQ20160219-4@2x.png
