控制器

7.x

7.x 5.5

Laravel 项目开发规范 /

资源控制器

必须优先使用 Restful 资源控制器。

单数 or 复数？

必须使用资源的复数形式，如：

类名：PhotosController

文件名：PhotosController.php

错误的例子：

类名：PhotoController

文件名：PhotoController.php

保持短小精炼

必须保持控制器文件代码行数最小化，还有可读性。

不应该 为「方法」书写注释，这要求方法取名要足够合理，不需要过多注释；
应该为一些复杂的逻辑代码块书写注释，主要介绍产品逻辑 - 为什么要这么做。；
不应该 在控制器中书写「私有方法」，控制器里 应该 只存放「路由动作方法」；
绝不遗留「死方法」，就是没有用到的方法，控制器里的所有方法，都应该被使用到，否则应该删除；
绝不在控制器里批量注释掉代码，无用的逻辑代码就必须清除掉。

本文章首发在 LearnKu.com 网站上。

Founder 10.3k 声望

维护者 @ LearnKu.com

我的灵智天成外包工作室有提供产品策划、设计、开发（PHP/Go/Java）、App 开发等服务。

《L02 从零构建论坛系统》

以构建论坛项目 LaraBBS 为线索，展开对 Laravel 框架的全面学习。应用程序架构思路贴近 Laravel 框架的设计哲学。

《L03 构架 API 服务器》

你将学到如 RESTFul 设计风格、PostMan 的使用、OAuth 流程，JWT 概念及使用和 API 开发相关的进阶知识。

点赞

推荐文章：

更多推荐...

依赖注入？依赖注入是如何实现解耦的? 57 / 17 |

Laravel 应用设计：单行为控制器的魅力 17 / 15 |

Redis 使用 Lua 脚本替代 SETNX / DECR 保证原子性 45 / 14 |

老死机带你深入理解 Laravel 之验证器下 24 / 2 |

老死机带你深入理解 Laravel 之验证器上（控制器参数解析） 25 / 4 |

详解 PHP 反射的基本使用 48 / 6 |

讨论数量: 3

发起讨论只看当前版本

勇敢的心

10个月前

控制器中的一些逻辑方法写在哪?

0 个点赞 | 6 个回复 | 问答 | 课程版本 5.5

Lvsi-China

2年前

控制器的名称必须使用复数形式？

0 个点赞 | 4 个回复 | 问答 | 课程版本 5.5

ccccccccccc

2年前

例如模型，表单验证器都需要基类，而控制器不用呢？

0 个点赞 | 0 个回复 | 问答 | 课程版本 5.5