最近做一個項目，前后端交互的api文檔一直以excel和word的形式管理，覺得很不方便，于是就是想找個更直觀的方式。在網(wǎng)上找了一圈，有一些看起來很不錯（沒用過，所以只能說看起來很不錯）的開源api管理平臺，比如EasyAPI。
但是，我又不想將api放在別人的服務(wù)器上，繼續(xù)尋找，發(fā)現(xiàn)了showdoc。這是個可以部署到自己服務(wù)器的開源api管理項目，使用的php。于是，我開始在自己的mac上折騰Apache+PHP+MySQL，下面進入正題。
Apache+PHP配置
mac osx系統(tǒng)都自帶了Apache和PHP環(huá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)如下默認的“It works!”界面，則表示Apache開啟成功。
開啟PHP
開啟PHP，需要修改Apache配置文件，方法如下：
- 打開終端，輸入命令：
sudo vim /etc/apache2/httpd.conf - 找到
#LoadModule php5_module libexec/apache2/libphp5.so，去掉注釋（刪除前面的井號）。
mac下Apache的默認文件夾為/Library/WebServer/Documents，在該目錄下創(chuàng)建一個名為index.php文件，在文件中添加如下內(nèi)容：<?php phpinfo(); ?>。刪除原目錄下的index.html文件，然后在瀏覽器中輸入localhost，如果出現(xiàn)如下PHP的info頁，則表示PHP開啟成功，如果不成功，用前面的命令重啟Apache再試。
修改Apache目錄
上面說到了mac下Apache的默認文件夾為/Library/WebServer/Documents，該目錄默認是隱藏的，操作不是很方便，我們可以將其修改成自定義的目錄。
- 打開終端，輸入命令：
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。進入下載頁面后，會提示你登陸或注冊，這里不必理會，直接點擊底部的“No thanks, just start my download.”即可開始下載。
雙擊下載的dmg安裝，一直下一步安裝，最后安裝完成后會彈出一個提示，告訴你MySQL為root@localhost賬號生成了一個臨時密碼，務(wù)必將這個密碼保存下來。
啟動MySQL
-
進入系統(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è)置的密碼登陸?？吹饺缦聝蓚€頁面，就大功告成了??！
