Yii 2.0 权威指南

路由

随着资源和控制器类准备,您可以使用URL如 http://localhost/index.php?r=user/create访问资源,类似于你可以用正常的Web应用程序做法。

在实践中,你通常要用美观的URL并采取有优势的HTTP动词。 例如,请求POST /users意味着访问user/create动作。 这可以很容易地通过配置urlManager应用程序组件来完成 如下所示:

'urlManager' =>
	[     
	'enablePrettyUrl' =>
	true,     
	'enableStrictParsing' =>
	true,     
	'showScriptName' =>
	false,     
	'rules' =>
	[     
	    ['class' =>
	'yii\rest\UrlRule', 'controller' =>
	'user'],     
	], ] 

相比于URL管理的Web应用程序,上述主要的新东西是通过RESTful API 请求yii\rest\UrlRule。这个特殊的URL规则类将会 建立一整套子URL规则来支持路由和URL创建的指定的控制器。 例如, 上面的代码中是大致按照下面的规则:

[     
	'PUT,PATCH users/<id>' =>
	'user/update',     
	'DELETE users/<id>' =>
	'user/delete',     
	'GET,HEAD users/<id>' =>
	'user/view',     
	'POST users' =>
	'user/create',     
	'GET,HEAD users' =>
	'user/index',     
	'users/<id>' =>
	'user/options',     
	'users' =>
	'user/options', ] 

该规则支持下面的API末端:

  • GET /users: 逐页列出所有用户;
  • HEAD /users: 显示用户列表的概要信息;
  • POST /users: 创建一个新用户;
  • GET /users/123: 返回用户为123的详细信息;
  • HEAD /users/123: 显示用户 123 的概述信息;
  • PATCH /users/123 and PUT /users/123: 更新用户123;
  • DELETE /users/123: 删除用户123;
  • OPTIONS /users: 显示关于末端 /users 支持的动词;
  • OPTIONS /users/123: 显示有关末端 /users/123 支持的动词。

您可以通过配置 only 和 except 选项来明确列出哪些行为支持, 哪些行为禁用。例如,

[     
	'class' =>
	'yii\rest\UrlRule',     
	'controller' =>
	'user',     
	'except' =>
	['delete', 'create', 'update'], ], 

您也可以通过配置 patterns 或 extraPatterns 重新定义现有的模式或添加此规则支持的新模式。 例如,通过末端 GET /users/search 可以支持新行为 search, 按照如下配置 extraPatterns 选项,

[     
	'class' =>
	'yii\rest\UrlRule',     
	'controller' =>
	'user',     
	'extraPatterns' =>
	[     
	    'GET search' =>
	'search',     
	], 

您可能已经注意到控制器IDuser以复数形式出现在users末端。 这是因为 yii\rest\UrlRule 能够为他们使用的末端全自动复数化控制器ID。 您可以通过设置 yii\rest\UrlRule::pluralize 为false 来禁用此行为,如果您想 使用一些特殊的名字您可以通过配置 yii\rest\UrlRule::controller 属性。

版权及转载说明

本站原创、转载文章欢迎任何形式的转载,但请务必注明出处,尊重他人劳动共创开源社区

本站转载文章版权归原作者所有,如发现本站文章涉嫌侵权请点击「联系我们」反馈,本站将给予删除

本教程数据来源「http://www.yiichina.com/doc/guide/2.0」