mirror of
https://github.com/yiisoft/yii2.git
synced 2025-11-01 11:39:41 +08:00
Update rest-routing.md
This commit is contained in:
@ -1,7 +1,7 @@
|
|||||||
路由
|
路由
|
||||||
=======
|
=======
|
||||||
|
|
||||||
随着资源和控制器类准备,您可以使用URL如
|
随着资源和控制器类准备,您可以使用 URL 如
|
||||||
`http://localhost/index.php?r=user/create` 访问资源,类似于你可以用正常的 Web 应用程序做法。
|
`http://localhost/index.php?r=user/create` 访问资源,类似于你可以用正常的 Web 应用程序做法。
|
||||||
|
|
||||||
在实践中,你通常要用美观的 URL 并采取有优势的 HTTP 动词。
|
在实践中,你通常要用美观的 URL 并采取有优势的 HTTP 动词。
|
||||||
@ -23,7 +23,7 @@
|
|||||||
相比于 URL 管理的 Web 应用程序,上述主要的新东西是通过 RESTful API
|
相比于 URL 管理的 Web 应用程序,上述主要的新东西是通过 RESTful API
|
||||||
请求 [[yii\rest\UrlRule]] 。这个特殊的 URL 规则类将会
|
请求 [[yii\rest\UrlRule]] 。这个特殊的 URL 规则类将会
|
||||||
建立一整套子 URL 规则来支持路由和 URL 创建的指定的控制器。
|
建立一整套子 URL 规则来支持路由和 URL 创建的指定的控制器。
|
||||||
例如, 上面的代码中是大致按照下面的规则:
|
例如,上面的代码中是大致按照下面的规则:
|
||||||
|
|
||||||
```php
|
```php
|
||||||
[
|
[
|
||||||
@ -39,15 +39,15 @@
|
|||||||
|
|
||||||
该规则支持下面的 API 末端:
|
该规则支持下面的 API 末端:
|
||||||
|
|
||||||
* `GET /users`: 逐页列出所有用户;
|
* `GET /users`:逐页列出所有用户;
|
||||||
* `HEAD /users`: 显示用户列表的概要信息;
|
* `HEAD /users`:显示用户列表的概要信息;
|
||||||
* `POST /users`: 创建一个新用户;
|
* `POST /users`:创建一个新用户;
|
||||||
* `GET /users/123`: 返回用户为 123 的详细信息;
|
* `GET /users/123`:返回用户为 123 的详细信息;
|
||||||
* `HEAD /users/123`: 显示用户 123 的概述信息;
|
* `HEAD /users/123`:显示用户 123 的概述信息;
|
||||||
* `PATCH /users/123` and `PUT /users/123`: 更新用户 123;
|
* `PATCH /users/123` 和 `PUT /users/123`:更新用户 123;
|
||||||
* `DELETE /users/123`: 删除用户 123;
|
* `DELETE /users/123`:删除用户 123;
|
||||||
* `OPTIONS /users`: 显示关于末端 `/users` 支持的动词;
|
* `OPTIONS /users`:显示关于末端 `/users` 支持的动词;
|
||||||
* `OPTIONS /users/123`: 显示有关末端 `/users/123` 支持的动词。
|
* `OPTIONS /users/123`:显示有关末端 `/users/123` 支持的动词。
|
||||||
|
|
||||||
您可以通过配置 `only` 和 `except` 选项来明确列出哪些行为支持,
|
您可以通过配置 `only` 和 `except` 选项来明确列出哪些行为支持,
|
||||||
哪些行为禁用。例如,
|
哪些行为禁用。例如,
|
||||||
@ -78,7 +78,7 @@
|
|||||||
您可以通过设置 [[yii\rest\UrlRule::pluralize]] 为 false 来禁用此行为。
|
您可以通过设置 [[yii\rest\UrlRule::pluralize]] 为 false 来禁用此行为。
|
||||||
|
|
||||||
> Info: 控制器的 ID 复数化由 [[yii\helpers\Inflector::pluralize()]] 完成。该方法遵循
|
> Info: 控制器的 ID 复数化由 [[yii\helpers\Inflector::pluralize()]] 完成。该方法遵循
|
||||||
特定的规则. 举个例子, 单词 `box` 会被复数化为 `boxes` 而不是 `boxs`。
|
特定的规则。举个例子,单词 `box` 会被复数化为 `boxes` 而不是 `boxs`。
|
||||||
|
|
||||||
如果自动复数化不能满足你的需求,你也可以配置
|
如果自动复数化不能满足你的需求,你也可以配置
|
||||||
[[yii\rest\UrlRule::controller]] 属性来明确指定如何将端点URL中使用的名称映射到
|
[[yii\rest\UrlRule::controller]] 属性来明确指定如何将端点URL中使用的名称映射到
|
||||||
@ -108,4 +108,3 @@
|
|||||||
],
|
],
|
||||||
],
|
],
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user