最近做一個項目诈唬，前后端交互的api文檔一直以excel和word的形式管理，覺得很不方便宁否，于是就是想找個更直觀的方式窒升。在網(wǎng)上找了一圈缀遍，有一些看起來很不錯（沒用過慕匠，所以只能說看起來很不錯）的開源api管理平臺，比如EasyAPI域醇。
但是台谊，我又不想將api放在別人的服務(wù)器上，繼續(xù)尋找譬挚，發(fā)現(xiàn)了showdoc锅铅。這是個可以部署到自己服務(wù)器的開源api管理項目，使用的php减宣。于是盐须，我開始在自己的mac上折騰Apache+PHP+MySQL，下面進(jìn)入正題漆腌。
Apache+PHP配置
mac osx系統(tǒng)都自帶了Apache和PHP環(huán)境贼邓，只是默認(rèn)情況下沒有開啟，我個人設(shè)備環(huán)境如下：
- PHP版本：5.5.27
- Apache版本：2.4.16 (Unix)
- 系統(tǒng)版本：OS X EI Capitan（OS X 10.11）
開啟Apache
打開終端闷尿，輸入?如下開啟命令塑径。
- 開啟Apache：
sudo apachectl start - 關(guān)閉Apache：
sudo apachectl stop - 重啟Apache：
sudo apachectl restart
在瀏覽器中輸入localhost，?如果出現(xiàn)如下默認(rèn)的“It works!”界面填具，則表示Apache開啟成功统舀。
開啟PHP
開啟PHP，需要修改Apache配置文件劳景，方法如下：
- 打開終端誉简，輸入命令：
sudo vim /etc/apache2/httpd.conf - 找到
#LoadModule php5_module libexec/apache2/libphp5.so，去掉注釋（刪除前面的井號）盟广。
mac下Apache的默認(rèn)文件夾為/Library/WebServer/Documents描融，在該目錄下創(chuàng)建一個名為index.php文件，在文件中添加如下內(nèi)容：<?php phpinfo(); ?>衡蚂。刪除原目錄下的index.html文件窿克，然后在瀏覽器中輸入localhost，如果出現(xiàn)如下PHP的info頁毛甲，則表示PHP開啟成功年叮，如果不成功，用前面的命令重啟Apache再試玻募。
修改Apache目錄
上面說到了mac下Apache的默認(rèn)文件夾為/Library/WebServer/Documents只损，該目錄默認(rèn)是隱藏的，操作不是很方便，我們可以將其修改成自定義的目錄跃惫。
- 打開終端叮叹，輸入命令：
sudo vim /etc/apache2/httpd.conf - 找到如下兩處
DocumentRoot "/Library/WebServer/Documents"
<Directory "/Library/WebServer/Documents"> - 將兩處中引號中的目錄替換為自定義的目錄
完成以上三步后，重啟Apache爆存，將之前創(chuàng)建的index.php文件拷貝到自定義目錄中蛉顽，然后在瀏覽器中輸入localhost，如果出現(xiàn)PHP的info頁先较，則表示?目錄修改成功携冤。
MySQL安裝
OSX 10.11沒有自帶MySQL，需要我們自己安裝闲勺。這里只介紹最簡單的方式曾棕，到MySQL官網(wǎng)下載最新的dmg安裝包，我本人下載的是mysql-5.7.11-osx10.10-x86_64.dmg菜循。進(jìn)入下載頁面后翘地，會提示你登陸或注冊，這里不必理會癌幕，直接點擊底部的“No thanks, just start my download.”即可開始下載衙耕。
雙擊下載的dmg安裝，一直下一步安裝序芦，最后安裝完成后會彈出一個提示臭杰，告訴你MySQL為root@localhost賬號生成了一個臨時密碼，務(wù)必將這個密碼保存下來谚中。
啟動MySQL
-
進(jìn)入系統(tǒng)偏好設(shè)置渴杆，點擊MySQL。
QQ20160219-2@2x.png - 點擊Start MySQL Server
QQ20160219-1@2x.png
修改root用戶的密碼
打開終端宪塔，輸入命令（將temppassword替換為之前保存的臨時密碼）：
/usr/local/mysql/bin/mysqladmin -u root -p'temppassword' password 'newpassword'
修復(fù)“2002 MySQL Socket error”
如果出現(xiàn)“2002 MySQL Socket error”錯誤磁奖，表示無法找到支持MySQL的c/s通信的socket。原因是MySQL將其放在 /tmp ?目錄某筐，而OSX將其放在 **/var/mysql **目錄比搭。所以我們只需要創(chuàng)建一個軟鏈接，輸入以下兩個命令即可：
創(chuàng)建目錄：sudo mkdir /var/mysql
創(chuàng)建軟鏈接：sudo ln -s /tmp/mysql.sock /var/mysql/mysql.sock
phpMyAdmin
完成以上兩步南誊，MySQL就算安裝配置完成了身诺，不過為了方便，有必要安裝一個可視化的工具抄囚，我選擇phpMyAdmin霉赡。
直接到phpMyAdmin官網(wǎng)下載最新的zip包，建議下載多語言版本幔托，支持簡體中文穴亏。下載完成后蜂挪，將解壓后的文件夾重命名為phpMyAdmin，然后放置到自定義的Apache路徑的根目錄下嗓化。
在瀏覽器中輸入localhost/phpMyAdmin棠涮，出現(xiàn)MySQL的登陸頁面，在該頁面可以設(shè)置語言刺覆，然后用root和之前設(shè)置的密碼登陸严肪。看到如下兩個頁面隅津，就大功告成了Ｎ艽埂劲室！
