wordpress_env_setup_manual (final)

wp-workshop-install-guide

# WordPress 開發環境安裝手冊


1. 為方便「WordPress 佈景主題實戰講堂」課程進行，降低安裝運行 WordPress 開發環境的問題，因此本課程設計了使用 VirtualBox 虛擬環境的方式來架設開發環境，好處是不會影響到既有的環境。不過只要能在自己的本機上運行 WordPress ，不一定要按照本手冊的方式來準備開發環境。
2.  本課程使用 Vagrant 的命令列工具來管理虛擬主機的開發環境，在 Windows 的環境中，除了安裝 Vagrant 和 VirtualBox之外，需要另外安裝 Git Bash，如果是Mac或Linux的用戶則不需要。

## (一)安裝 Vagrant 
> http://www.vagrantup.com/downloads.html

請選擇適合的作業系統版本安裝。這是我們用來安裝和控制Wordpress 開發環境及應用程式的命令列工具

## (二)安裝 VirtualBox
> https://www.virtualbox.org/wiki/Downloads

請選擇適合的作業系統版本安裝。安裝完後，會透過vagrant指令來控制VirtualBox，不用另外啟動

## (三) Windows 作業系統需要另外下載 Git Bash
https://msysgit.github.io


## (四)下載 Wordpress 的 Vagrant 設定檔
> http://static.itho.me/workshop/wp-workshop.zip


## (五)安裝 Wordpress 開發環境

### (A)Windows 用戶
1. 建議將下載下來的 wp-workshop.zip 移至 C 槽或 D 槽目錄底下解壓縮，以下將以 C 槽為例說明。
2.  在 C 槽解壓縮 wp-workshop ，解壓後的目錄為 wordpress-workshop
3. 打開 Git Bash，會啟用一個類似 cmd.exe 執行後的終端機的命令列黑色畫面
4. 執行以下命令切換到 wordpress-workshop 目錄
> cd /c/wordpress-workshop

5. 列出目錄中的檔案
> ls
    
    -  這時應該可以看到  Vagrantfile、wp-workshop.box 兩個檔案，和 wordpress 目錄

6.  將開發環境的虛擬主機載入，執行下列指令:
> vagrant box add wp-workshop wp-workshop.box

7. 執行完畢後，接下來則是啟用虛擬主機
> vagrant up

8. 如果上面兩個步驟都順利執行結束，我們已經設定好 WordPress的開發環境，可以打開瀏覽器，輸入下列的網址，就可以看到 WordPress 的畫面。這時只要編輯 wordpress 目錄中的檔案，畫面也會即會同步更新。
> http://localhost:3000


### (B)Mac 或 Linux 用戶
1. 建議將 wp-workshop.zip 放置在個人的家目錄(打開Finder後，按 **command+shift+H** 或是 Finder 選單中選擇【前往】-> 【個人專屬】)，並解壓縮。以下說明假設解壓縮的目題是在個人家目錄底下，解開後的目錄為 wordpress-workshop。
2. 打開終端機，並執行以下命令切換到 wordpress-workshop 目錄
> cd ~/wordpress-workshop
3. 列出目錄中的檔案
> ls

       -  這時應該可以看到  Vagrantfile、wp-workshop.box 兩個檔案，和 wordpress 目錄

4.  將開發環境的虛擬主機載入，執行下列指令:
> vagrant box add wp-workshop wp-workshop.box

5. 執行完畢後，接下來則是啟用虛擬主機
> vagrant up

6. 如果上面兩個步驟都順利執行結束，我們已經設定好 WordPress的開發環境，可以打開瀏覽器，輸入下列的網址，應該就可以看到 WordPress 的畫面。這時只要編輯wordpress目錄中的檔案，畫面也會即會同步更新。
> http://localhost:3000


## (六)關閉 Wordpress 開發環境
- 要關閉這個開發環境，在wordpress-workshop 路徑下，執行以下命令即可:
> vagrant halt

- 可以執行以下指令來確認是否有正常關閉(看見poweroff的狀態即成功)
> vagrant status

- 下次要再啟動，一樣執行 `vagrant up` 即可

- 如果已經確定日後不再使用這個開發環境，可以執行下面指令，刪除已安裝的虛擬主機，減少佔用硬碟空間
> vagrant box remove wp-workshop


## WordPress 管理帳號及密碼  
```
username: admin 
password: password
```
## MySQL 資料庫帳密

```
MySQL
User: root
Pass: password
```