Duster 风格指南全解读Tighten 团队沉淀的 Laravel 代码规范精华清单【免费下载链接】dusterAutomatic configuration for Laravel apps to apply Tightens standard linting code standards.项目地址: https://gitcode.com/gh_mirrors/du/dusterDuster是一个面向 Laravel 应用的自动代码规范工具由知名服务商 Tighten 团队开发能将业界沉淀多年的 PHP 与 Blade 代码风格一键应用到你的项目中。本文带你完整解读 Duster 内置的四大检查器TLint、PHP_CodeSniffer、PHP CS Fixer、Pint背后的规则精华帮你轻松掌握这套 Laravel 风格指南 为什么需要 Duster统一 Laravel 代码风格的终极方案团队协作中代码风格不一致是 Code Review 的头号噪音源。Duster 的思路是把紧的规则固化成一个包一条命令lint检查全部问题一条命令fix自动修复能修的部分。它并非单打独斗而是编排了四个各司其职的工具工具职责特点TLint检查 Laravel 专属写法有预设 Formatter可自动修复和 Linter仅提示PHP_CodeSniffer检查命名规范等不可自动修复的问题使用Tighten预设以 PSR-1 为基座PHP CS Fixer补充 Pint 不支持的自定义规则如类成员排序、控制器方法排序PintLaravel 官方代码风格默认Laravel预设 Tighten 定制规则总览可参考项目内的风格指南文档style-guide.mdTLint 规则清单最懂 Laravel 的那组检查TLint 是 Duster 的灵魂规则全部来自 Tighten 对 Laravel 项目的实战沉淀分为Formatter可自动修复与Linter仅报告两类。 高频 Formatter 规则速览view()传参方式推荐view(x, [key $v])而不是view(x)-with(key, $v)门面Facade全限定导入use Illuminate\Support\Facades\DB;而非use DB;Mailable 设置位置from()、subject()等应放在build()方法中而非构造函数模型日期字段Laravel 8 已废弃$dates属性统一改用$casts路由路径不带前导斜杠Route::get(home, ...)请求取值与验证优先用request(id)助手函数验证用request()-validate(...)或抽取 FormRequestauth()优于 Auth 门面视图中更简洁易读 Blade 模板三大间距规则易混淆点这是新手最容易问的一组规则TLint 对 Blade 的括号间距有分裂要求指令与括号之间无空格section(sidebar)、class([...])控制结构之间留空格if (true)、unless (false)渲染内容前后留空格{{ 1 1 }}而非{{1 1}}口诀标签贴括号条件让一步输出两眼睁大眼此外 Linter 还会提醒中间件应写在路由层而非控制器里、避免使用json指令改用{{ $model }}自动转义或json_encode等。PHP_CodeSniffer 规则清单命名与反调试红线这一层主要强制PSR-1 命名规范规则配置见 standards/Tighten/ruleset.xml类名必须 StudlyCaps、常量全大写下划线、方法名 camelCase类名必须与文件名一致测试与数据库文件豁免部分命名约束如 Pest 的it_...写法最有 Tighten 特色的是禁用函数清单——以下调试痕迹一律不允许出现在提交代码中dd()、dump()、var_dump()、ray()、compact()另外自定义 SniffTighten.PHP.UseConfigOverEnv源码UseConfigOverEnvSniff.php要求在业务代码中用config()替代env()——env()只应出现在config/目录下这是 Laravel 应用环境隔离的最佳实践。PHP CS Fixer 定制规则给类成员排座次Duster 通过三个自定义 Fixer 强制了统一的类成员顺序源码位于app/Fixer/ClassNotation/目录custom_controller_order控制器中先index、create、store、show、edit、update、destroy再其他公有方法——打开任何控制器都是熟悉的阅读顺序custom_ordered_class_elements普通类按Trait → 静态属性 → 常量 → 实例属性 → 构造函数 → 方法排序custom_phpunit_orderPHPUnit/Pest 测试夹具固定在类顶部这套排序规则让代码结构可预测新成员读陌生文件时几乎零学习成本 Pint 规则清单Laravel 预设上的 Tighten 手笔Pint 底层仍是 PHP CS FixerDuster 的 Pint 配置standards/pint.json在 Laravel 官方预设之上追加了一批定制规则常见影响包括大括号位置类与函数的大括号换行控制结构if/foreach大括号同行导入排序use语句按const → class → function分组、组内字母序new后不加括号new User而非new User()多行数组尾逗号、!后加空格! $bar、.concat两侧单空格字符串插值统一{$name}复合语法PHPUnit 注解风格使用test注解每条规则的具体 diff 示例都在 style-guide.md 中逐一列出可作为团队培训素材直接引用。一键上手从检查到修复只需两条命令# 安装开发依赖 composer require tightenco/duster --dev # 全量检查 / 全量自动修复 ./vendor/bin/duster lint ./vendor/bin/duster fix # 只处理 Git 未提交的脏文件提交前快速检查 ./vendor/bin/duster lint --dirty用 duster.json 定制检查范围在项目根目录创建duster.json即可控制范围与扩展脚本示例可参考项目自带的 duster.json{ include: [app, tests], exclude: [tests/fixtures], scripts: { lint: { PHPStan: [./vendor/bin/phpstan, analyse] } } }配置解析逻辑见 app/Support/DusterConfig.php它内置了vendor/、node_modules/、storage/等默认排除项支持通配符路径也允许把 PHPStan 等外部命令挂进lint流程。容器环境下Sail/DDEV/Lando/Warden可用--env参数自动适配。总结一套开箱即用的 Laravel 风格基线Duster 把 Tighten 团队多年 Laravel 咨询经验压缩成了四道关卡TLint 管框架习惯、PHP_CodeSniffer 管命名红线、PHP CS Fixer 管结构排序、Pint 管基础格式。对于新手团队直接沿用默认配置就是最佳起点对于成熟团队再按各项目对应的tlint.json、.phpcs.xml.dist、pint.json做增量定制。把这套 Laravel 代码规范交给 Duster 自动执行你就能把 Code Review 的精力真正留给业务逻辑本身 【免费下载链接】dusterAutomatic configuration for Laravel apps to apply Tightens standard linting code standards.项目地址: https://gitcode.com/gh_mirrors/du/duster创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考