於 2014/12/6, 7, 13, 14 受邀於 彰化師範大學 資訊工程學系系學會 進行 Laravel 工作坊，內容共分 12 個主題： 0. 工作坊簡介 - http://www.slideshare.net/shengyou/0-43453831 1. 開發環境建置 - http://www.slideshare.net/shengyou/1-43453834 2. 開發流程與工具介紹 - http://www.slideshare.net/shengyou/2-43453836 3. 專案啟動與設定 - http://www.slideshare.net/shengyou/3-43453837 4. Schema & Migration 操作 - http://www.slideshare.net/shengyou/4-schemamigration 5. Model & Seeding 整合 - http://www.slideshare.net/shengyou/5-modelseeding 6. 使用 Eloquent ORM - http://www.slideshare.net/shengyou/6-eloquent-orm 7. Route 機制 - http://www.slideshare.net/shengyou/7-route 8. View 與 Blade 樣板引擎 - http://www.slideshare.net/shengyou/8-view 9. 連結 Controller - http://www.slideshare.net/shengyou/9-controller 10. CRUD 綜合應用 - http://www.slideshare.net/shengyou/10-crud 11. 使用者認證 - http://www.slideshare.net/shengyou/11-43453858 12. 應用程式佈署 - http://www.slideshare.net/shengyou/12-43453865 完整課程訊息請見：http://www.laravel-dojo.com/courses/laravel4-first-class 程式碼範例請見：https://github.com/laravel-dojo/laravel4-first-class-example

1. Laravel 工作坊
應用程式 署
shengyou @ 彰師大資工系學會 (2014.12.14)

2. 階段任務
• 將現階段已經完成的程式碼， 署至
pagodabox PaaS 平台、取得公開網址，並
可在瀏覽器裡瀏覽專案網站

3. 應用程式 署
• 把寫好的程式碼放到公開的網路主機，供
使用者可以瀏覽、使用 些應用程式。
個從個人的開發機將原始碼放到網路主機
的動作，稱之為 署
• 本工作坊將示範如何將寫好的程式碼 署
至 PaaS 平台供測試、練習之用
★ 參考：http://en.wikipedia.org/wiki/Software_deployment

4. 共享主機
• 一般常見的網路主機往往是 共享主機
(shared hosting)，常會有以下缺點：
- PHP 版本過舊
- 資源、頻 共搶/分配不均
- 無法安裝額外套件

5. 什麼是 PaaS？
• PaaS = Platform as a Service
• 平台即服務 是一種雲端運算服務，由服務
供應商提供網路、伺服器、作業系統、
存空間等，讓使用者能將其原始碼部署至
雲端。使用者不需要管理與控制雲端基礎
設施，只需自行處理應用程式部署與原始
碼管理。
★ 參考：http://en.wikipedia.org/wiki/Platform_as_a_service

6. 使用 PaaS 署的好處
• 一般而言，PaaS 平台都支援版本控制、
PHP 版本設定、多種資料庫、動態因應流
量擴展等功能
• 因此，你只需要專注在程式開發即可，其
他所有工作包括主機安裝、 署設定、流
量擴充等都可以由 PaaS 自動完成

7. pagoda box 簡介

8. 什麼是 pagoda box？
• 一個 PaaS 服務， 冊帳號後，就可以隨
時 署多個應用程式至該平台，並取得動
態網址，供開發人員測試、Demo
• 免費額度 能使用有限的運算能力
(200MB RAM)、10MB 資料庫、且若應用
程式無人瀏覽時，反應速度會自動降低
★ 參考：https://pagodabox.com/cloud-hosting-price

9. 申請 pagoda box 帳號
https://pagodabox.com/

10. 申請 pagoda box 帳號

11. 署前置工作

12. 產生 SSH Key
• pagoda box 的遠端連線使用 SSH 連線加
密，因此要先產生一組 Key 做為加密金鑰
• 打開 comder.exe 並輸入以下指令
★ SSH Key 產生教學：http://help.pagodabox.com/customer/portal/articles/202068#setup-ssh-keys-bash
$
ssh-­‐keygen
-­‐t
rsa
-­‐C
"{請換成 的
email
}"
畫面會請 輸入
passphrase
(密碼)
可不輸入
完成後會產生兩個 案：
C:{家目錄}.sshid_rsa
(私鑰)
C:{家目錄}.sshid_rsa.pub
(公鑰)

13. 登記 SSH Key
• 接著，要把自己的公錀登記在 pagoda box
的帳號內， 樣 pagoda box 才會允許我們
連上主機
• 請先登入 pagoda box，然後進入帳號設定
https://dashboard.pagodabox.com/account/
edit
★ SSH Key 登記教學：http://help.pagodabox.com/customer/portal/articles/202068#add-ssh-pagoda

14. 設定 SSH Key
帳號設定
已經登記的 Key
增加新的 Key
Key 的名稱 (可自取)
公錀內容

15. 增加 Boxfile
• 請在專案資料夾內新增一個 Boxfile 案
• pagodabox 是透過讀取 Boxfile 了解應用程
式所需要的所有元件，並依照 Boxfile 內
的指令進行自動化 署
• 請參考教學範例內的 Boxfile 進行設定
★ Boxfile 說明：http://help.pagodabox.com/customer/portal/articles/175475

16. 設定 database.php
• 由於 pagoda box 的 MySQL 資料庫是在第
一次 署時自動建立的，因此使用者帳號/
密碼等資 ，會由系統環境變數傳給
Laravel 使用
• 設定 production 的資料庫連線資 從系統
環境變數接受

17. 設定 database.php
• 請參考教學懶人包內的 app/config/
database.php 設定 production 的連線資
★ database 設定說明：http://help.pagodabox.com/customer/portal/articles/175426

18. 安裝 adminer
• 若要直接連上 pagoda box 的 MySQL，需
要安裝額外的 ruby 工具。但其實可透過
自行安裝網頁版工具來瀏覽 MySQL 內容
• 請將教學範例內的 adminer 資料夾下載
後，放在 public 資料夾底下
• 請先在本機端測試使用
★ adminer 官方網站：http://www.adminer.org/

19. .htaccess 調整
• 由於安裝了 adminer，在瀏覽器內瀏覽ad
發生網頁無限跳轉迴圈。需要將 Laravel
原生的 .htaccess 設定 解掉一行
• 請參考教學範例內的 .htaccess 進行設定

20. 執行 署

21. pagoda box 署流程
★ 參考：http://help.pagodabox.com/customer/portal/articles/174146-launching-your-first-app
SourceTree
pagoda box
web
db
client
local
commit
deploy
分析 Boxfile
create
browse

22. 啟始一個新的 App
https://dashboard.pagodabox.com/

23. 設定 App 名稱
自定 App 名稱
選擇由空的 存庫開始

24. 選擇 署模式
記下 組資

25. SourceTree 設定
我們要根據 pagoda box 提供的遠端
存庫資 ，設定本機端的 存庫
設定 存庫

26. 新增 remote

27. 設定 remote 資
把 pagoda 提供的
資料填在

28. remote 設定完成

29. 把程式 Push 到遠端
都要打勾
都要打勾

30. pagoda box 署中
展開看 署過程 log
pagoda box 的系統動作

31. pagoda box 署完畢
署完成！

32. pagoda box 署指令
• 將 pagoda box 存庫設定為本機 存庫的
遠端
• 將本機 存庫的 案推送 (push) 至 pagoda
box 主機
$
git
remote
add
pagoda
git@git.pagodabox.com:{App
名稱}.git
$
git
push
pagoda
-­‐-­‐all
★ 參考：http://help.pagodabox.com/customer/portal/articles/174146#launch-your-app-on-pagoda-box

33. 驗證 署結果
• 瀏覽程式碼上線成果
查看 App 線上狀態

34. 檢視 App 線上狀態
系統各元件狀態
各系統設定功能
署版本設定

35. 瀏覽資料庫內容
• 打開瀏覽器，輸入 App 公開網址後加 /
adminer/ 即可進入 adminer 登入頁
輸入 pagoda 的
資料庫連線資

36. 取得資料庫連線資
• 進入 App 系統狀態頁，查詢連線資
展開
展開後取得 MySQL 連線資

37. 0 downtime 署
★ 參考：http://blog.pagodabox.com/wp-content/uploads/2012/02/deploy_hooks_diagram.png
SourceTree
pagoda box
web 1
db
local
commit
deploy
分析 Boxfile
create
browse
web 2
client
replace
browse

38. 階段檢查表
• 確認有 pagoda box 的帳號並可登入
• 啟動一個 pagoda box App
• 確認 SourceTree 的 remote 設定
• 確認 App 有可瀏覽的公開 URL，並可成功
瀏覽

39. 問與答
學員可開始練習、實作

40. 工作坊總結
• 在 個工作坊裡，我們透過 12 個學習主
題，從開發環境建置與工具介紹、版本控
制、Laravel MVC 及 Blog 功能實作，以及
上線 署等。期待能從 一連串的實作
中，了解 Laravel 應用程式開發的技巧、
享受開發的樂趣！