最近做一個項目,前後端互動的api文檔一直以excel和word的形式管理,覺得很不方便,於是就是想找個更直觀的方式。在網上找了一圈,有一些看起來很不錯(沒用過,所以只能說看起來很不錯)的開源api管理平台,比如EasyAPI。
但是,我又不想將api放在別人的伺服器上,繼續尋找,發現了showdoc。這是個可以部署到自己伺服器的開源api管理項目,使用的php。於是,我開始在自己的mac上折騰Apache+PHP+MySQL,下面進入正題。
Apache+PHP配置
mac osx系統都內建了Apache和PHP環境,只是預設情況下沒有開啟,我個人裝置環境如下:
- PHP版本:5.5.27
- Apache版本:2.4.16 (Unix)
- 系統版本:OS X EI Capitan(OS X 10.11)
開啟Apache
開啟終端,輸入如下開啟命令。
- 開啟Apache:sudo apachectl start
- 關閉Apache:sudo apachectl stop
- 重啟Apache:sudo apachectl restart
在瀏覽器中輸入localhost,如果出現如下預設的“It works!”介面,則表示Apache開啟成功。
localhost-osx-apache.png
開啟PHP
開啟PHP,需要修改Apache設定檔,方法如下:
- 開啟終端,輸入命令:sudo vim /etc/apache2/httpd.conf
- 找到#LoadModule php5_module libexec/apache2/libphp5.so,去掉注釋(刪除前面的井號)。
mac下Apache的預設資料夾為/Library/WebServer/Documents,在該目錄下建立一個名為index.php檔案,在檔案中添加如下內容:。刪除原目錄下的index.html檔案,然後在瀏覽器中輸入localhost,如果出現如下PHP的info頁,則表示PHP開啟成功,如果不成功,用前面的命令重啟Apache再試。
QQ20160219-0@2x.png
修改Apache目錄
上面說到了mac下Apache的預設資料夾為/Library/WebServer/Documents,該目錄預設是隱藏的,操作不是很方便,我們可以將其修改成自訂的目錄。
- 開啟終端,輸入命令:sudo vim /etc/apache2/httpd.conf
- 找到如下兩處 DocumentRoot "/Library/WebServer/Documents"
- 將兩處中引號中的目錄替換為自訂的目錄
完成以上三步後,重啟Apache,將之前建立的index.php檔案拷貝到自訂目錄中,然後在瀏覽器中輸入localhost,如果出現PHP的info頁,則表示目錄修改成功。
MySQL安裝
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
啟動MySQL
- 進入系統喜好設定,點擊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'
修複“2002 MySQL Socket error”
如果出現“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
phpMyAdmin
完成以上兩步,MySQL就算安裝配置完成了,不過為了方便,有必要安裝一個可視化的工具,我選擇phpMyAdmin。 直接到phpMyAdmin官網下載最新的zip包,建議下載多語言版本,支援簡體中文。下載完成後,將解壓後的檔案夾重新命名為phpMyAdmin,然後放置到自訂的Apache路徑的根目錄下。 在瀏覽器中輸入localhost/phpMyAdmin,出現MySQL的登陸頁面,在該頁面可以設定語言,然後用root和之前設定的密碼登陸。看到如下兩個頁面,就大功告成了!!
QQ20160219-3@2x.png
QQ20160219-4@2x.png
參考資料
- Mac下配置Apache + Php + Mysql環境
- Get Apache, MySQL, PHP and phpMyAdmin working on OSX 10.11 El Capitan