微信小程序实践-- 服务器端接口restful配置

说干咱就干,老沙灰常高兴的开始yii2程序的restful配置过程。

RESTful

老沙计划使用 xgh.nai8.me/xcx 作为接口的基本地址,将来会有比如

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

类似的url,这样是符合restful。

为了以后版本化,将每个版本的接口以模块的形式建立,当然建立支持restful和建立普通的模块并没有差别,使用gii的模块生成即可。

此处省略好几个字,模块建立完成。

alt

yii2框架内置是支持restful规范的,按照yii2的规则做我们可以轻松实现比如数据表数据的获取、插入、更新、删除等基础操作以及登录验证等功能。

也就是说我省了很多事情~~,当然我们还是需要简单配置的,这个配置主要是urlManager及模块控制器的继承问题。

urlManager

如果要实现上面的url样子,我们必须进行url美化,这需要web服务器的支持(apache&nginx如何支持url重写可以参考 速查表),单单这样还不够,yii2提供了restful专有的url规范,需要按照它的要求配置。

对于一般的restful规则的yii2路由配置如下图

alt

红色框内的代表一个标准restful中控制器路由规则,绿色框内是你必须要填写的,其他的except、pluralize、extraPatterns非必填,具体使用场景以后用到会说明。

这里要说明的参数是pluralize,在restful使用上一直存在两种观点,就是对于资源在url上的表现应该是单数还是复数问题,yii2默认是复数形式,如果你想使用单数可以将pluralize设置为false即可。

在pluralize=false的情况下url是类似于 GET xgh.nai8.me/xcx/album 的样子。

在我们设置了urlManager后,yii2就变得智商满满了,当过来一个 GET xgh.nai8.me/xcx/albums 请求后,yii2知道这是一个要获取资源结果集的请求,则会去调用xcx模块下的album控制器的actionIndex,以此类推yii2提供了很多个内置的action识别,具体见下图

alt

当然具体如何实现的你可以参考 yii\rest\UrlRule.php 类及yii2的actions函数。

小提示:在兄弟连PHP原创视频中对这个原理也进行了详细的解析(《Yii2的RESTful讲解》第三节)

配置控制器

urlManager配置完成,接下来就是写一个控制器了,老沙对此很熟悉,不就是一个继承问题么!!!

是的,这是一个继承问题,如果你想让yii2支持restful,请将对应控制器继承到 yii\rest\ActiveController 上,最简单的一个具有restful资源操作能力的控制器如下图。

alt

是的,就是这样,当控制器继承于 ActiveController 在指定一个$modelClass后,这个控制器就可以对 $modelClass 对应的数据表进行列表、详情、生成、更新、删除等操作,而你无需再写任何对应代码,简单吧~~

这里要注意几点

第一: 必须指定$modelClass,每个控制器代表一种资源,隐身就是一个数据表中的数据或你操作系统的文件云云,总之它是一种资源。

第二: 这里的AblumController就是urlMananger中的'controller' => 'xcx/album', 控制器的名字于单复数的设置无关。

完事了

简单配置后,老沙搞定了服务器端的配置,接下来他计划使用小程序和yii2实现一个队相册列表的功能实现,下一篇告诉你。

原创声明,本文系作者授权云+社区发表,未经许可,不得转载。

如有侵权,请联系 yunjia_community@tencent.com 删除。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏数据和云

你造吗,Oracle SQLplus 也有History命令了

很多时候我们只能通过SQLPlus来操作数据库,而当一个SQL执行结果太多时,我们要回翻之前的SQL语句就会很麻烦,甚至可能由于ssh客户端或SQLPlus客户...

33550
来自专栏慎独

如何在Github上给别人的项目贡献代码

15140
来自专栏Java成神之路

Maven之 环境搭建

这几天开始了maven的学习,看了孔浩老师的视频(http://pan.baidu.com/s/1o7bg2h0),以及黄勇大牛的博客(http://my.os...

27510
来自专栏Java3y

Linux用户和权限管理看了你就会用啦

没想到上一篇能在知乎获得千赞呀,Linux也快期末考试了,也有半个月没有写文章了。这篇主要将Linux下的用户和权限知识点再整理一下。

3.4K10
来自专栏积累沉淀

MySQL5.7.10下载及安装及配置

MySQL5.7.10下载及安装及配置 一.下载 自MySQL版本升级到5.7以后,其安装及配置过程和原来版本发生了很大的变化,下面详细介绍5.7版本MySQL...

30390
来自专栏跟着阿笨一起玩NET

win7组件服务COM+应用程序编录错误解决办法

一般情况下,我们遇到过的COM+应用程序编录错误共有两个:(1)第一个是打开COM+应用程序时出现“编录错误,执行最后操作发生错误,错误代码8007042C-依...

28210
来自专栏程序猿DD

Jenkins:配置信息变更历史

作者:sparkdev 出处:http://www.cnblogs.com/sparkdev/ 像 Jenkins 这样的系统,使用的过程就是配置文件变更的过程...

26850
来自专栏地方网络工作室的专栏

Vue2+VueRouter2+Webpack+Axios 构建项目实战2017重制版(十)打包项目并发布到子目录

Vue2+VueRouter2+Webpack+Axios 构建项目实战2017重制版(十)打包项目并发布到子目录 前情回顾 通过上一章《Vue2+VueRou...

25680
来自专栏蜉蝣禅修之道

ssh隧道与代理

35440
来自专栏python3

diango使用数据库

之前写的页面,虽然和用户交互得很好,但并没有保存任何数据,页面一旦关闭,或服务器重启,一切都将回到原始状态。

14730

扫码关注云+社区

领取腾讯云代金券