qossmic / deptrac

Deptrac是一款静态代码分析工具,可以帮助强制实施软件层之间依赖关系的规则。

安装:596,256

依赖项: 10

建议者: 0

安全性: 0

星标:2,603

关注者: 45

分支: 135

开放问题: 35

2.0.1 2024-06-17 10:43 UTC

README

Deptrac是一款针对PHP的静态代码分析工具,可以帮助你在项目中传达、可视化和实施架构决策。你可以自由定义你的架构层以及应应用于它们的规则。

例如,你可以使用Deptrac来确保项目中捆绑/模块/扩展之间的真正独立,以便更容易重用。

Deptrac可以用于CI管道中,以确保拉取请求没有违反你定义的任何架构规则。通过可选的Graphviz或Mermaidjs格式化程序,你可以可视化你的层、规则和违规。

文档

您可以在/docs目录中找到文档或访问文档页面:[https://qossmic.github.io/deptrac](https://qossmic.github.io/deptrac)

入门

您可以通过Composer安装Deptrac。我们建议使用[deptrac](https://github.com/qossmic/deptrac)包

composer require --dev qossmic/deptrac

一旦您已下载/安装了deptrac,您需要创建一个配置文件,在其中定义您的层和通信规则集。此配置文件以YAML或PHP编写,默认情况下存储在项目根目录中的deptrac.yaml

Deptrac可以使用init命令为您生成模板。

vendor/bin/deptrac init

有了这个文件,您可以通过运行analyse命令来分析您的代码

vendor/bin/deptrac

# which is equivalent to
vendor/bin/deptrac analyse --config-file=deptrac.yaml

要运行Deptrac,您至少需要PHP 8.1。

只要[nikic/php-parser](https://github.com/nikic/PHP-Parser)可以解析它,您就可以分析需要较旧PHP版本的项目的代码。

如何贡献

请参阅贡献指南或前往开发仓库qossmic/deptrac-src

其他文档

  • 向后兼容性 - 我们如何处理向后兼容性的一般信息
  • 升级指南 - 列出在将Deptrac升级到新版本时需要解决的向后不兼容更改以及如何进行。
  • 核心概念 - 更详细地解释层、规则和违规
  • 配置 - depfile中所有可用设置的参考
  • 收集器 - 定义您的层的Deptrac中可用的收集器的参考
  • 格式化程序 - 列出Deptrac支持的不同输出格式
  • 调试 - 调试命令概述
  • 行为准则 - 我们的社区标准
  • 贡献 - 关于提交代码更改的建议,例如如何运行测试或如何构建包含您的更改的phar文件,以便您可以使用它来分析您的项目
  • 安全指南 - 如何报告安全漏洞