最近在做Yii2.0 RESTful API功能，找了好久的資料，才找到這類的教程，感謝該作者，以下內(nèi)容根據(jù)我的項目實際情況做了一定的修改。
安裝yii2.0
安裝 Composer 后，您可以通過在 Web 可訪問的文件夾下運行以下命令來 安裝Yii應(yīng)用程序模板：
composer create-project --prefer-dist yiisoft/yii2-app-basic basic
初始化高級模板
輸入"./init"后會出現(xiàn)以下內(nèi)容
Yii Application Initialization Tool v1.0
Which environment do you want the application to be initialized in?
[0] Development
[1] Production
Your choice [0-1, or "q" to quit] 0
Initialize the application under 'Development' environment? [yes|no] yes
Start initialization ...
修改數(shù)據(jù)庫連接屬性
打開 commonconfigmain-local.php,配置數(shù)據(jù)庫連接信息
'db' => [
'class' => 'yii\db\Connection',
'dsn' => 'mysql:host=127.0.0.1;dbname=yii',
'username' => 'root',
'password' => 'root',
'charset' => 'utf8',
],
執(zhí)行 migrate 數(shù)據(jù)庫遷移
拷貝backend目錄，命名為api
打開apiconfigmain.php 修改id,controllerNamespace等，將所有backend替換為api：
return [
'id' => 'app-api',
'basePath' => dirname(__DIR__),
'controllerNamespace' => 'api\controllers',
]
打開apiconfigmain.php開啟url路由美化規(guī)則
'urlManager' => [
'enablePrettyUrl' => true,
'showScriptName' => false,
'rules' => [
],
],
打開commonconfigbootstrap.php添加以下別名
Yii::setAlias('@api', dirname(dirname(__DIR__)) . '/api');
為什么要單獨創(chuàng)建API應(yīng)用
單獨創(chuàng)建API應(yīng)用，目的是便于維護(hù)，可以避免以下問題
- 配置的沖突
- 控制器的命名不便
- url美化規(guī)則沖突
- 分工明確frontend為前臺目錄；backend為后臺目錄；api為api目錄
接下來打開 apicontrollers 新建一個User控制器，繼承 yiirestActiveController，命名為 UserController,代碼如下：
?php
namespace api\controllers;
use yii\rest\ActiveController;
class UserController extends ActiveController
{
public $modelClass = 'common\models\User';
}
配置URL規(guī)則
為剛才的 user控制器添加url美化規(guī)則
打開 apiconfigmain.php 修改 components屬性，添加下列代碼:
...
'urlManager' => [
'enablePrettyUrl' => true,
'enableStrictParsing' => true,
'showScriptName' => false,
'rules' => [
['class' => 'yii\rest\UrlRule',
'controller' => 'user'
],
],
]
...
ok，到此就成了一個 符合 RESTful 風(fēng)格的API
看起來在控制器了什么也沒有寫，只是指定了一個模型，但是她的背后完成了很多的功能哦，列表如下：
- GET /users: 逐頁列出所有用戶
- HEAD /users: 顯示用戶列表的概要信息
- POST /users: 創(chuàng)建一個新用戶
- GET /users/123: 返回用戶 123 的詳細(xì)信息
- HEAD /users/123: 顯示用戶 123 的概述信息
- PATCH /users/123: and PUT /users/123: 更新用戶123
- DELETE /users/123: 刪除用戶123
- OPTIONS /users: 顯示關(guān)于末端 /users 支持的動詞
- OPTIONS /users/123: 顯示有關(guān)末端 /users/123 支持的動詞
如何訪問呢
你可以使用 curl命令進(jìn)行訪問,命令如下:
curl -i -H "Accept:application/json" http://localhost/users
命令行下還是比較麻煩的，也不方便測試，推薦使用 API測試工具
這類的工具有很多，我就不一一列舉了，這里推薦 Postman,很好很強(qiáng)大，Chorme也有插件，可以安裝，這里我推薦直接下載軟件安裝調(diào)試，比較方便
你可能發(fā)現(xiàn)了 訪問任何路由地址都是加的s,users ， 為什么呢? 資源，你要理解 資源二字，既然是資源肯定是個集合，肯定有一大堆，所以要加上復(fù)數(shù)，我是這么理解的。
你說我就是不想加上s,我就想采用http://localhost/user 這種方式來進(jìn)行訪問，好吧，可以，滿足你，只是不推薦
繼續(xù)打開配置文件apiconfigmain.php修改剛才添加的 urlManager 如下:
'urlManager' => [
'enablePrettyUrl' => true,
'enableStrictParsing' => true,
'showScriptName' => false,
'rules' => [
['class' => 'yii\rest\UrlRule',
'controller' => 'user',
'pluralize' => false, //設(shè)置為false 就可以去掉復(fù)數(shù)形式了
],
],
]
加入 'pluralize' => false, 就表示去掉復(fù)數(shù)形式了，再次強(qiáng)調(diào)不推薦
ok，在控制器中我們沒有寫任何一句代碼，他就給我們生成許多方法，但是有時候我們可能需要修改一些代碼，來達(dá)到我們想要的效果，比如連表查詢，然后再返回數(shù)據(jù)
接下來我們就實現(xiàn)這樣的功能:
打開剛才新建的user控制器, 重寫 action方法:
?php
namespace api\controllers;
use yii\rest\ActiveController;
class UserController extend extends ActiveController
{
public $modelClass = 'common\models\User';
public function actions()
{
$action= parent::actions(); // TODO: Change the autogenerated stub
unset($action['index']);
unset($action['create']);
unset($action['update']);
unset($action['delete']);
}
public function actionIndex()
{
//你的代碼
}
}
這樣我們就可以重寫他的代碼了。哈哈
我們再新建一個自己的 action
?php
namespace api\controllers;
use yii\rest\ActiveController;
class UserController extends ActiveController
{
public $modelClass = 'common\models\User';
public function actions()
{
$action= parent::actions(); // TODO: Change the autogenerated stub
unset($action['index']);
unset($action['create']);
unset($action['update']);
unset($action['delete']);
}
public function actionIndex()
{
//你的代碼
}
public function actionTest() //假如是get請求
{
//業(yè)務(wù)邏輯
}
}
然后試著訪問一下 http://localhost/users/test，報錯？找不到？
報錯就對了，那是因為我們沒有設(shè)置其他路由訪問
修改 apiconfigmain.php
'urlManager' => [
'enablePrettyUrl' => true,
'enableStrictParsing' => true,
'showScriptName' => false,
'rules' => [
['class' => 'yii\rest\UrlRule',
'controller' => 'user',
//'pluralize' => false, //設(shè)置為false 就可以去掉復(fù)數(shù)形式了
'extraPatterns'=>[
'GET send-email'=>'test'
],
],
],
]
接下來重新訪問就沒有問題了，ps：你自己編寫的任何 action 都要在 extraPatterns 進(jìn)行配置
以上就是本文的全部內(nèi)容，希望對大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。
您可能感興趣的文章:- 關(guān)于Yii中模型場景的一些簡單介紹
- Yii2中的場景(scenario)和驗證規(guī)則(rule)詳解
- Yii2中簡單的場景使用介紹
- Yii 2.0中場景的使用教程
- Yii2.0框架behaviors方法使用實例分析
- yii2.0框架使用 beforeAction 防非法登陸的方法分析
- YII2.0框架行為（Behavior）深入詳解
- Yii2.0框架實現(xiàn)帶分頁的多條件搜索功能示例
- 修改yii2.0用戶登錄使用的user表為其它的表實現(xiàn)方法(推薦)
- yii2.0框架場景的簡單使用示例
