68 lines
1.6 KiB
Markdown
68 lines
1.6 KiB
Markdown
後端伺服器
|
||
===
|
||
主要的東西都放在Server那邊，處理手機客戶端與伺服器資料的溝通。
|
||
|
||
包含每位學生的學習資料、場地狀況、學習教材。以及處理學習路徑規劃。
|
||
|
||
## 使用需求
|
||
|
||
* PHP5.3 以上，需要有以下Extension:
|
||
* pdo_mysql
|
||
* zip
|
||
* MariaDB 5.5.31 (可用MySQL)
|
||
|
||
***
|
||
|
||
## 開發需求
|
||
* 支援UTF-8編碼的文字編輯器
|
||
* 開發文件產生器: phpdoc
|
||
* 自動化建置工具
|
||
* guard（需有ruby環境）
|
||
* guard-shell
|
||
* guard-livereload
|
||
|
||
## 建置開發環境
|
||
### 安裝php, ruby 環境
|
||
TODO: 代補，需有`gem`, `phar`
|
||
|
||
### 安裝Guard
|
||
|
||
gem install guard
|
||
gem install guard-shell
|
||
gem install guard-livereload
|
||
|
||
#### 瀏覽器plugin安裝
|
||
[LiveReload - browser extensions](http://feedback.livereload.com/knowledgebase/articles/86242-how-do-i-install-and-use-the-browser-extensions-)
|
||
|
||
支援主流瀏覽器:
|
||
|
||
* Firefox
|
||
* Chrome
|
||
* Safari
|
||
|
||
### 安裝phpdoc
|
||
|
||
pear channel-discover pear.phpdoc.org
|
||
pear install phpdoc/phpDocumentor
|
||
|
||
## 自動化建置
|
||
很簡單，只要下以下指令即可啟動
|
||
|
||
guard
|
||
|
||
啟動後會監視專案內的`.php`檔案，一有任何變動將會
|
||
|
||
* phpdoc: 重新建立開發文件
|
||
* livereload: 呼叫瀏覽器自動重新整理
|
||
|
||
#### 相關參考
|
||
* <https://github.com/guard/guard>
|
||
* <https://github.com/guard/guard/wiki/List-of-available-Guards>
|
||
|
||
## 開發文件
|
||
已將整份專案使用[PHPDocumentor](http://www.phpdoc.org/)產生出[開發文件網站](docs/index.html)
|
||
|
||
產生指令（若有使用Guard的話可省略，會自動連同一起產生）:
|
||
|
||
phpdoc -d ./htdocs/lib -t ./docs/
|