# 下載與安裝
PhalApi 2.x 與PhalApi 1.x 系列一樣，要求PHP >= 5.3.3。
## 快速安裝
PhalApi 2.x 版本的安裝很簡單，有兩種方式。
### composer一鍵安裝
使用composer創建項目的命令，可實現一鍵安裝。
```bash
$ composer create-project phalapi/phalapi
```
> 溫馨提示：關于composer的使用，請參考[Composer 中文網 / Packagist 中國全量鏡像](http://www.phpcomposer.com/)。
### 手動下載安裝
或者，也可以進行手動安裝。首先下載[phalapi](https://github.com/phalapi/phalapi/tree/master-2x)項目**master-2x分支**源代碼。下載解壓后，進行可選的composer更新，即：
```bash
$ composer update
```
> 溫馨提示：為提高友好度，phalapi中已帶有缺省vendor安裝包，從而減輕未曾接觸過composer開發同學的學習成本。即便composer安裝失敗，也可正常運行PhalApi 2.x。
### Nginx配置
如果使用的是Nginx，可參考以下配置。
```
server {
listen 80;
server_name dev.phalapi.net;
root /path/to/phalapi/public;
charset utf-8;
location / {
index index.php;
}
location ~ \.php$ {
fastcgi_split_path_info ^(.+\.php)(/.+)$;
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}
access_log logs/dev.phalapi.net.access.log;
error_log logs/dev.phalapi.net.error.log;
}
```
重啟Nginx并配置本地HOSTS后，可通過以下鏈接，訪問默認接口服務。
```
http://dev.phalapi.net
```
> 溫馨提示：推薦將訪問根路徑指向/path/to/phalapi/public。后續開發文檔中，如無特殊說明，均約定采用此配置方式。
### Apache配置
如果使用的是Apache，可參考以下配置。
```
// TODO
```
### XAMPP配置
如果使用的是XAMPP集成環境，只需要將項目源代碼phalapi整個目錄復制到xampp的htdocs目錄下即可。打開XAMPP控制面板并啟動Apache后，便可通過以下鏈接，訪問默認接口服務。
```
http://localhsot/phalapi/public/
```
以上不管何種配置，正常情況下，訪問默認接口服務可以看到類似這樣的輸出：
```
{
"ret": 200,
"data": {
"title": "Hello PhalApi",
"version": "2.0.1",
"time": 1501079142
},
"msg": ""
}
```
運行效果，截圖如下：
至此，安裝完畢！
## 如何升級PhalApi 2.x框架？
在composer的管理下，升級PhalApi 2.x 版本系列非常簡單。只需要修改composer.json文件，指定相應的版本即可。
例如，當前使用的是PhalApi 2.0.1，如下所示：
```
{
"require": {
"phalapi/kernal": "2.0.1"
}
}
```
當需要升級到PhalApi 2.0.2，則可以改成：
```
{
"require": {
"phalapi/kernal": "2.0.2"
}
}
```
隨后執行composer更新操作即可。對應命令操作為：
```bash
$ composer update
```
#### 溫馨提示：關于composer版本的說明，可參考[Composer中文文檔 - 包版本](http://docs.phpcomposer.com/01-basic-usage.html#Package-Versions)。
