在KirinBDF`2.0` 版本中,應用目錄主要包含`controller`、`model`、`validate`、`route`這四個目錄以及存放公共函數的`common.php`文件,例如像是這樣的目錄結構:
```
├─app 應用目錄
│ ├─app_name 應用目錄
│ │ ├─controller 控制器目錄
│ │ ├─model 模型目錄
│ │ ├─route 路由目錄
│ │ ├─validate 驗證目錄
│ │ ├─common.php 函數文件
│ │ └─ ... 更多類庫文件
│ │
│ └─common.php 公共函數文件
```
當需要新增一個接口時,先要在控制器目錄添加一個新的文件。例如對于Hello World示例,可以使用你喜歡的編輯器創建一個app/app_name/controller/HelloController.php文件,并在里面放置以下代碼。
```
<?php
namespace app\app_name\controller;
use app\common\ApiBaseController;
class HelloController extends ApiBaseController
{
public function index()
{
$this->sendSuccess(200, "Hello World");
}
}
```
>[danger]編寫接口時,需要特別注意:
* 控制器需要繼承`ApiBaseController`。
* 定義接口方法,必須為`public`訪問權限。
* `請求路由`和響應的`HTTP狀態碼`要遵循REST設計風格。