分享下团队的开发规范 ——《Laravel 项目开发规范》

分享 Summer ⋅ 于 2017-08-09 15:50:09 ⋅ 最后回复由 远客 2017-08-16 09:13:26 ⋅ 3935 阅读

file

这是一套严格的团队开发规范,是 优帆远扬 团队内部 Laravel 工程师践行的开发规范。我们崇尚开放和透明的工程师文化,所以我们尽可能把信息公开。希望这些信息可以为他人参考和借鉴,发挥最大的价值。

Laravel 文档和网上的各种教程,会教授我们一个任务可以使用好几种方法来完成。对于框架设计来说,灵活是件好事,能提供给开发者不同的选项,能让框架适用更多的用户场景。但是对于团队的协同开发来说,大部分时候,更多的选项反而是累赘。此文档,正是为解决此问题而诞生。

链接:https://fsdhub.com/books/laravel-specification


入门书籍推荐 —— :books: 《Laravel 入门教程》

本帖已被设为精华帖!
本帖由 Aufree 于 2周前 加精
回复数量: 45
  • waney
    2017-08-09 15:54:22

    沙发!~

  • BradStev Naive !
    2017-08-09 16:15:55

    只能注册这个网站才能看啊,请问一下有没有其他的渠道可以查看的?

  • 無限之秋
    2017-08-09 16:19:47

    阅读完毕!这个规范和我自己的差不多,学习借鉴了~哈哈哈哈哈哈

  • 沈益飞
    2017-08-09 16:27:00

    无法用言语表达,感谢,为我们这些小开发者团队指明了方向。

  • tonyski
    2017-08-09 16:38:38

    哇,干货!一支对规范迷迷糊糊的,例如那些单复数命名等等。总而言之十分感谢! :smile:

  • mrstranger 乌合之众...
    2017-08-09 16:54:48

    视频播放器为大家推荐IINA,开源免费,比 MPlayerX 好用

  • godruoyi 听着大悲咒敲代码
    2017-08-09 17:07:10

    不要拦我, 我要打赏

  • skyLee
    2017-08-09 17:12:49

    app下载在那里哟

  • lybc
    2017-08-09 17:18:33

    可否部分借鉴作为自己所在团队的开发规范?

    另外,如果不推荐 repository 的话,面对企业应用极其复杂的表单和报表逻辑,有什么比较好的方式来复用代码呢?

  • Insua
    2017-08-09 17:35:03

    看了一下,发现自己开发时,采用错误规范的时候比较多

  • Insua
    2017-08-09 18:03:17

    绝对不使用 Repository的话,模型会肥到天际的啊

  • Rekkles
    2017-08-09 18:06:22

    赞~

  • iwzh
    2017-08-09 18:13:10

    非常赞!

  • 23tl 用心写BUG,用脚做项目
    2017-08-09 18:22:16

    告诉20楼,我要嘿咻嘿咻

  • coolseven
    2017-08-09 20:30:11

    请问有没有针对Exception相关的规范呀?比如使用Exception来做流程控制之类的,很好奇

  • MarksGui
    2017-08-09 21:29:01

    看完后获益良多啊! 很多之前的疑惑渐渐感觉有点串起来了。 再次感谢无私奉献

  • Ryan 一个离不开Manual,Google和IDE的菜鸟码农!
    2017-08-09 21:59:31

    除了绝不使用Repository,其他基本差不多,赞

  • stoneworld
    2017-08-09 22:37:48

    赞同不使用 Repository

  • nff93
    2017-08-10 08:10:49

    必须使用Homestead。。。表示用的Valet

    楼下准备被 #14 @23tl 嘿咻嘿咻

  • MushishiXian
    2017-08-10 08:29:35

    绝不使用Repository的话,是简单加一层service层去处理复制逻辑吗?

  • MushishiXian
    2017-08-10 08:30:09

    @MushishiXian 打错....应该是 : 处理复杂逻辑

  • monkey 最重要的事,永远只有一件
    2017-08-10 09:10:00

    绝不使用 Repository !

  • 839891627
    2017-08-10 09:16:11

    受用了

  • 远客 收住心,全力拼
    2017-08-10 09:19:49

    除了绝不使用Repository,其他都赞

    对于有几百张表的项目,如果逻辑全写在模型里,想想都有点蛋疼

  • 孙健魁
    2017-08-10 09:42:12

    除了绝不使用Repository,其他都赞!规范是为了更好的协作,每个团队都有自己的规范,大致是相通的,没有对错,统一就是规范。

  • Summer MOD A Life-long learner.
    2017-08-10 10:11:09

    Repository 是一种设计模式,懂得怎么用,并且团队架构师认同即可,没有好坏,只是应用场景不同。
    讨论使用 Repository 是个无底洞,没有太大意义,只是一个选择而已。

    作为工匠,应该专注在你的作品上,而不是工具。

  • airycanon
    2017-08-10 11:13:23

    3.11. 前端开发
    “必须 使用 Elixir 做前端开发自动化工具”,应该加上 Mix。
    “必须 保证页面只加载一个 .css 文件” 和 “必须 保证页面只加载一个 .js 文件”,有时项目中只有某个页面用到一个比较大的 js 或者 css,我认为应该把它独立出来,不然会拖累其他无关页面的首次加载。

  • dinghua
    2017-08-10 11:23:38

    @Summer 这个文档的系统是你自己写的?

  • Summer MOD A Life-long learner.
    2017-08-10 11:28:42

    @dinghua 当然,怎么啦,字体不像是我写的?:smile_cat:

  • dinghua
    2017-08-10 11:29:53

    @Summer 看起来很强大,有么有考虑开源

  • weychen 一个php爱好者,希望让更多的人爱上php
    2017-08-10 15:58:49

    :+1:

  • Artisan
    2017-08-10 16:17:24

    熟悉了这个,是不是就离加入优帆远扬更近了一步呢 . 😄

  • Artisan
    2017-08-10 17:42:09

    从头到尾看了一遍,很赞,和我原来的习惯大多相同,这份规范值得遵守。

  • Artisan
    2017-08-10 17:52:37

    如果有关于测试的规范就更好了

  • simaguo
    2017-08-11 09:03:15

    对于我这种单打独斗的人很有帮助

  • mostwin
    2017-08-11 11:12:39

    除了绝不使用Repository,其他都赞 :smile:

  • homer
    2017-08-11 14:09:13

    @远客 laravel框架的Model其实就是Repository的一种实现,反倒是真正意义的Model在laravel里面是没有的,有些项目为了弥补这点,专门做了schema类来放实际的model,虽然觉得也是多此一举。

    Respository用来进行resource操作,业务逻辑还是不能放进Repository里面的,放在哪里见仁见智,有的叫Biz,有点叫Serice,还有的叫Support。我倾向于用Service,因为很多逻辑是设计决定,而不是Biz里面的逻辑,Service更广泛一些。

    Anyway,不要过度设计。

  • lenon
    2017-08-11 14:32:37

    很有帮助,下个项目就参考这个开发规范了

  • xhh110 面向工资编程
    2017-08-15 00:34:40

    @lenon 同感。。。

  • jobsssss
    2017-08-15 11:24:57

    @远客 用traits来处理复杂逻辑不行吗?

  • jobsssss
    2017-08-15 11:28:35

    赞同不要使用Repository,从第一次使用这个玩意的时候,我就感觉这是茴香豆“茴”字的第5种写法

  • lybc
    2017-08-15 11:57:40

    我倒戈了- -,以前一直是把业务逻辑写在repository的,以后要改个名字

  • Ali PHP届的小学生.终生学习者...
    2017-08-15 16:51:13

    非常赞,收藏了。谢了。

  • bluegeek 富贵山庄,听竹轩下
    2017-08-15 20:04:17

    @mrstranger 是的 非常不错 一会在用。

  • 远客 收住心,全力拼
    2017-08-16 09:13:26

    @jobsssss 用 trait 来处理复杂逻辑是没问题的,用不用Repository本身没有太大问题,楼主说的,不要过度设计就好了。

暂无评论~~
  • 请注意单词拼写,以及中英文排版,参考此页
  • 支持 Markdown 格式, **粗体**、~~删除线~~、`单行代码`, 更多语法请见这里 Markdown 语法
  • 支持表情,使用方法请见 Emoji 自动补全来咯,可用的 Emoji 请见 :metal: :point_right: Emoji 列表 :star: :sparkles:
  • 上传图片, 支持拖拽和剪切板黏贴上传, 格式限制 - jpg, png, gif
  • 发布框支持本地存储功能,会在内容变更时保存,「提交」按钮点击时清空
Ctrl+Enter