删除文件 docs/docs/ggs5th.md

This commit is contained in:
唐永川
2026-06-26 13:37:26 +00:00
committed by Gitee
parent c4ed84b590
commit 915d4b72a6

View File

@@ -1,53 +0,0 @@
---
url: ggs5th
---
# 路由编写规范
<a name="bbcf486c"></a>
## 路由闭包
<br />**绝不** 在路由配置文件里书写『闭包路由』或者其他业务逻辑代码 。<br />
<br />路由器要保持干净整洁,**绝不** 放置除路由配置以外的其他程序逻辑。<br />
<a name="cd664586"></a>
## Restful 路由
<br />**必须** 优先使用 Restful 路由,配合资源控制器使用,见 [文档](http://learnku.com/docs/laravel/5.5/controllers#RESTful-%E8%B5%84%E6%BA%90%E6%8E%A7%E5%88%B6%E5%99%A8)。<br />
<br />![](../assets/1600072664191-a563c65e-c263-4757-829b-f78b72118c3d.png)<br />
<br />超出 Restful 路由的,**应该** 模仿上图的方式来定义路由。
<a name="972987d4"></a>
## 单数 or 复数?
<br />资源路由路由 URI **必须** 使用复数形式,如:<br />
- `/photos/create`
- `/photos/{photo}`
<br />错误的例子如:<br />
- `/photo/create`
- `/photo/{photo}`
<a name="2d07baec"></a>
## 路由命名
<br />所有路由都 **必须** 使用 `name` 方法进行命名。<br />
<br />**必须** 使用『资源前缀』作为命名规范,如下的 `users.follow`,资源前缀的值是 `users.`<br />
```bash
# dingoapi路由写法和标准lumen有所差异
$api->post('/users/{id}/follow', ['as' => 'users.follow', 'uses' => 'UsersController@follow']);
```
<a name="038efffd"></a>
## 获取 URL
<br />获取 URL **必须** 遵循以下优先级:<br />
```bash
app('Dingo\Api\Routing\UrlGenerator')->version('v1')->route('users.index');
```