规范

Code Standards

php 代码规范

前言

开发哲学

• 不写重复逻辑代码
• 优先选择框架提倡做法，尽量不修改原生机制
• 优先选择官方推崇方案，然后是有经验的人的方案，最后才是独创方案

过于灵活

在 laravel 中同一个功能会有不同的解决方案，然后效果是一样的，没有规范会使得可读性低，结构混乱。
决策提前做好，所有成员必须严格遵守。

规范的执行

规范就是规范，可以讨论改正，但在执行的时候 必须 严格遵守。
要有大局观，做到团结一致，把个人的喜好放一边，把整个团队的执行效率放在第一位。

项目规范

框架版本选择

laravel 使用 LTS 版本
composer create-project laravel/laravel . --prefer-dist "5.5.*"

开发专用拓展包

避免无用的负载，请加上参数 –dev

# composer require laracasts/generators --dev
public function register()
{
    if ($this->app->environment() == 'local') {
        $this->app->register('Laracasts\Generators\GeneratorsServiceProvider');
    }
}

辅助函数

<?php
# bootstrap/app.php 文件的最顶部
require __DIR__ . '/helpers.php';

编码规范

代码风格

https://blog.youkuaiyun.com/onegoal/article/details/79587377

laravel 安全

• APP_DEBUG=false
• 模板输出必须使用 {{ }},{!! !!} 进行非转义输出时，必须使用 HTMLPurifier for Laravel 5
• 使用 raw() 来编写复杂查询语句时，必须 使用数据绑定
• 批量赋值：protected $guarded = ['id', 'is_admin'];