說干咱就干，老沙灰常高興的開始了，在這一篇老沙將帶著你完成yii2程序的restful配置過程。

RESTful

老沙計(jì)劃使用 xgh.nai8.me/xcx 作為接口的基本地址，將來會(huì)有比如

• GET xgh.nai8.me/xcx/albums
• GET xgh.nai8.me/xcx/albums/…
• ....

類似的url，這樣是符合restful。

為了以后版本化，將每個(gè)版本的接口以模塊的形式建立，當(dāng)然建立支持restful和建立普通的模塊并沒有差別，使用gii的模塊生成即可。

此處省略好幾個(gè)字，模塊建立完成。

 

 

yii2框架內(nèi)置是支持restful規(guī)范的，按照yii2的規(guī)則做我們可以輕松實(shí)現(xiàn)比如數(shù)據(jù)表數(shù)據(jù)的獲取、插入、更新、刪除等基礎(chǔ)操作以及登錄驗(yàn)證等功能。

也就是說我省了很多事情~~，當(dāng)然我們還是需要簡(jiǎn)單配置的，這個(gè)配置主要是urlManager及模塊控制器的繼承問題。

urlManager

如果要實(shí)現(xiàn)上面的url樣子，我們必須進(jìn)行url美化，這需要web服務(wù)器的支持（apache&nginx如何支持url重寫可以參考 速查表），單單這樣還不夠，yii2提供了restful專有的url規(guī)范，需要按照它的要求配置。

對(duì)于一般的restful規(guī)則的yii2路由配置如下圖

 

紅色框內(nèi)的代表一個(gè)標(biāo)準(zhǔn)restful中控制器路由規(guī)則，綠色框內(nèi)是你必須要填寫的，其他的except、pluralize、extraPatterns非必填，具體使用場(chǎng)景以后用到會(huì)說明。

這里要說明的參數(shù)是pluralize，在restful使用上一直存在兩種觀點(diǎn)，就是對(duì)于資源在url上的表現(xiàn)應(yīng)該是單數(shù)還是復(fù)數(shù)問題，yii2默認(rèn)是復(fù)數(shù)形式，如果你想使用單數(shù)可以將pluralize設(shè)置為false即可。

在pluralize=false的情況下url是類似于 GET xgh.nai8.me/xcx/album 的樣子。

在我們?cè)O(shè)置了urlManager后，yii2就變得智商滿滿了，當(dāng)過來一個(gè) GET xgh.nai8.me/xcx/albums 請(qǐng)求后，yii2知道這是一個(gè)要獲取資源結(jié)果集的請(qǐng)求，則會(huì)去調(diào)用xcx模塊下的album控制器的actionIndex，以此類推yii2提供了很多個(gè)內(nèi)置的action識(shí)別，具體見下圖

 

 

當(dāng)然具體如何實(shí)現(xiàn)的你可以參考 yii\rest\UrlRule.php 類及yii2的actions函數(shù)。

小提示：在兄弟連PHP原創(chuàng)視頻中對(duì)這個(gè)原理也進(jìn)行了詳細(xì)的解析（《Yii2的RESTful講解》第三節(jié)）

配置控制器

urlManager配置完成，接下來就是寫一個(gè)控制器了，老沙對(duì)此很熟悉，不就是一個(gè)繼承問題么?。?！

是的，這是一個(gè)繼承問題，如果你想讓yii2支持restful，請(qǐng)將對(duì)應(yīng)控制器繼承到 yii\rest\ActiveController 上，最簡(jiǎn)單的一個(gè)具有restful資源操作能力的控制器如下圖。

 

 

是的，就是這樣，當(dāng)控制器繼承于 ActiveController 在指定一個(gè)$modelClass后，這個(gè)控制器就可以對(duì) $modelClass 對(duì)應(yīng)的數(shù)據(jù)表進(jìn)行列表、詳情、生成、更新、刪除等操作，而你無需再寫任何對(duì)應(yīng)代碼，簡(jiǎn)單吧~~

這里要注意幾點(diǎn)

第一：
必須指定$modelClass，每個(gè)控制器代表一種資源，隱身就是一個(gè)數(shù)據(jù)表中的數(shù)據(jù)或你操作系統(tǒng)的文件云云，總之它是一種資源。

第二：
這里的AblumController就是urlMananger中的'controller' => 'xcx/album', 控制器的名字于單復(fù)數(shù)的設(shè)置無關(guān)。

完事了

簡(jiǎn)單配置后，老沙搞定了服務(wù)器端的配置，接下來他計(jì)劃使用小程序和yii2實(shí)現(xiàn)一個(gè)隊(duì)相冊(cè)列表的功能實(shí)現(xiàn)，下一篇告訴你。