关于规范 | 前言 |《 Laravel 项目开发规范 5.5》| Laravel China 社区
Laravel
话题列表
社区 Wiki
优质外文
招聘求职
Laravel 实战教程
社区文档
登录
注册
Laravel 项目开发规范
展开或关闭
前言
关于规范
过于灵活是一件糟糕的事情
关于「能愿动词」的使用
项目规范
Laravel 版本选择
开发和线上环境
开发专用扩展包
配置信息与环境变量
辅助函数
项目文档编写规范
工具统一
编码规范
代码风格
路由器
数据模型
控制器
视图
表单验证
授权策略
数据填充
Artisan 命令行
日期和时间
前端开发
中间件
杂项
Laravel 安全实践
Laravel 程序优化
代码生成器
附录
推荐阅读
readme-example.md
Laravel
首页
Laravel
Go
PHP
Vue.js
Python
Java
MySQL
Rust
LK
Elasticsearch
F2E 前端
Server
程序员
Database
DevTools
Computer Science
手机开发
AdonisJS
社区
Wiki
教程
Laravel 实战教程首页
《L01 Laravel 教程 - Web 开发实战入门》
《L02 Laravel 教程 - Web 开发实战进阶》
《L03 Laravel 教程 - 实战构架 API 服务器》
《L04 Laravel 教程 - 微信小程序从零到发布》
《L05 Laravel 教程 - 电商实战》
《L06 Laravel 教程 - 电商进阶》
《LX1 Laravel / PHP 扩展包视频教程》
《LX2 PHP 扩展包实战教程 - 从入门到发布》
《L07 Laravel 教程 - Laravel TDD 测试实战》
《LX3 Laravel 性能优化入门》
《LX4 Laravel / PHP 五分钟视频》
文档
社区文档首页
《Laravel 中文文档》
《Laravel 速查表》
《PHP 代码简洁之道》
《Laravel 编码技巧》
《Dcat Admin 中文文档》
《Laravel Nova 中文文档》
《Lumen 中文文档》
《Dingo API 中文文档》
《 Laravel 项目开发规范》
《构建 Laravel 开发环境》
登录
注册
微信登录
提交改进
关于规范
5.5
9.x
7.x
5.5
Laravel 项目开发规范
未匹配的标注
本文档最新版为 9.x，旧版本可能放弃维护，推荐阅读最新版！
说明
这是一套严格的团队开发规范，是 优帆远扬 团队内部 Laravel 工程师践行的开发规范。我们崇尚开放和透明的工程师文化，所以我们尽可能把信息公开。希望这些信息可以为他人参考和借鉴，发挥最大的价值。
目的
优帆远扬是一家崇尚远程协作的软件外包公司，工程师来自全球各地，规范化让我们的工程师训练有素，以此来提供更加高质量的软件交付。另一方面，我们也希望整个团队的项目经验能够得到继承，在每一次实战中不断进行总结和摸索，找到兼备开发效率、程序执行效率、扩展性和安全性的最佳实践，最终实现团体智慧的延续和精进。
优势
规范有以下优点：
高效编码 - 避免了过多的选择造成的『决策时间』浪费；
风格统一 - 最大程度统一了开发团队成员代码书写风格和思路，代码阅读起来如出一辙；
减少错误 - 减小初级工程师的犯错几率。
开发哲学
因为篇幅原因本规范无法涉及到项目里每一块代码的编写标准，所以此处重点说明下此规范遵循的『开发哲学』，开发中请把其当做指明灯，来指引你做决策：
DRY –「Don't Repeat Yourself」不写重复的逻辑代码；
约定俗成 - 「Convention Over Configuration」，优先选择框架提倡的做法，不过度配置；
KISS - 「Keep it Simple, Stupid」提倡简单易读的代码，不写高深、晦涩难懂的代码，不过度设计；
主厨精选 - 让有经验的人来为你选择方案，不独创方案；
官方提倡 - 优先选择官方推崇的方案。
设计理念
以下是一些优秀的『程序设计理念』：
MVC - Model, View, Controller ，以 MVC 为核心，严格控制 Controller 的可读性和代码行数；
Restful - 利用『资源化概念』和标准的 HTTP 动词来组织你的程序；
在此规范中，我们会将使用这两套理念作为程序设计基础。这些设计理念为我们设计程序提供了依据，遵循这些理念，能让程序变得清晰易读。
本文章首发在 LearnKu.com 网站上。
上一篇
下一篇
Markdown 文本
纠错改进
《L01 基础入门》
我们将带你从零开发一个项目并部署到线上，本课程教授 Web 开发中专业、实用的技能，如 Git 工作流、Laravel Mix 前端工作流等。
《L02 从零构建论坛系统》
以构建论坛项目 LaraBBS 为线索，展开对 Laravel 框架的全面学习。应用程序架构思路贴近 Laravel 框架的设计哲学。
推荐文章：
更多推荐...
博客
分享自己写的关于顺丰同城配送的扩展包
23
1年前
博客
Gitlab CI/CD 文件编写 推送代码 支持Psr规范性检查，自动化Phpunit测试
17
1年前
分享
使用laravel+colorui开发了一个关于朋友借钱的《好友欠条》小程序
12
29
1年前
博客
教你更优雅地写 API 之「规范响应数据」
90
31
2年前
博客
面试中关于nginx的问答
15
2年前
博客
代码提交规范检查与修复 php_codesniffer + composer-git-hooks
13
2年前
讨论数量: 0
发起讨论
只看当前版本
暂无话题~
社区赞助商
成为赞助商
关于 LearnKu
LearnKu 是终身编程者的修道场
做最专业、严肃的技术论坛
LearnKu 诞生的故事
资源推荐
《社区使用指南》
《文档撰写指南》
《LearnKu 社区规范》
《提问的智慧》
服务提供商
其他信息
成为版主
所有测验
联系站长（反馈建议）
粤ICP备18099781号-6
粤公网安备 44030502004330号
违法和不良信息举报
由 Summer 设计和编码 ❤
请登录
提交
忘记密码?
or
注册
第三方账号登录
微信登录
GitHub 登录
内容举报
匿名举报，为防止滥用，仅管理员可见举报者。
我要举报该，理由是：
垃圾广告：恶意灌水、广告、推广等内容
无意义内容：测试、灌水、文不对题、消极内容、文章品质太差等
违规内容：色情、暴利、血腥、敏感信息等
不友善内容：人身攻击、挑衅辱骂、恶意行为
科学上网：翻墙、VPN、Shadowsocks，政策风险，会被关站！
不懂提问：提问太随意，需要再做一遍《提问的智慧》测验
随意提问：提问没有发布在社区问答分类下
排版混乱：没有合理使用 Markdown 编写文章，未使用代码高亮
内容结构混乱：逻辑不清晰，内容混乱，难以阅读
标题随意：标题党、标题不释义
尊重版权：分享付费课程、破解软件（付费），侵犯作者劳动成果
其他理由：请补充说明
举报
取消