Composer如何配合Deptrac架构规则检查_Composer配合Deptrac架构规则检查实战-composer-PHP中文网

deptrac 需要 composer 支持是因为它依赖 composer.json 中的 autoload 配置来解析类的命名空间与路径映射，若 vendor/autoload.php 不存在或 autoload 配置无效，会导致 class not found 或依赖解析失败。

composer如何配合deptrac架构规则检查_composer配合deptrac架构规则检查实战

Deptrac 为什么需要 Composer 支持

Deptrac 本身是 PHP 架构分析工具，不依赖 Composer 运行，但实际项目中几乎必须通过 Composer 安装和加载。关键在于：deptrac 命令行工具需要正确识别项目中的类自动加载规则（即 autoload 和 autoload-dev 配置），而这些信息全部来自 composer.json。如果 Deptrac 无法读取或解析 autoload 配置，就会报错 Class not found 或直接跳过大量文件。

Deptrac 默认会尝试读取当前目录下的 composer.json，并调用 Composer 的 autoloader 机制来定位类
若项目使用 PSR-4、PSR-0、classmap 或 files 类型的 autoload，Deptrac 均能识别，但要求路径配置真实存在且可访问
如果 composer.json 中的 autoload 指向了未生成的 vendor/autoload.php（比如还没运行 composer install），Deptrac 会静默失败或报 Cannot open vendor/autoload.php

如何让 Deptrac 正确加载你的类

Deptrac 不会自动执行 composer dump-autoload，它只读取配置并尝试 require 对应的 autoload 文件。因此必须确保：

vendor/autoload.php 已存在（即已运行过 composer install 或 composer dump-autoload）
composer.json 中的 autoload 路径是相对项目根目录的，且不包含通配符或动态变量（Deptrac 不解析 PHP 代码，只做静态 JSON 解析）
若使用 autoload-dev（如测试类），需在 Deptrac 配置中显式启用：设置 include_dev_dependencies: true，否则 tests/ 下的类不会被扫描

示例常见错误配置：

"autoload": {
  "psr-4": {
    "App\": "src/"
  }
}

✅ 正确：Deptrac 能识别 src/ 下所有 App 命名空间类 ❌ 错误："App\": "src//"（末尾双斜杠）或 "App\": "${SRC_DIR}/"（环境变量）——Deptrac 解析失败，类无法加载

Deptrac 扫描范围与 Composer autoloader 的关系

Deptrac 的 paths 配置（在 deptrac.yaml 中）决定扫描哪些目录，但它不替代 autoload 配置。二者分工明确：

paths：告诉 Deptrac “去哪些文件夹里找 PHP 文件”
autoload（来自 composer.json）：告诉 Deptrac “这些 PHP 文件里定义的类，其命名空间和路径映射关系是什么”

这意味着：

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

即使某个目录在 paths 中，但如果它的命名空间没在 composer.json 的 autoload 里声明，Deptrac 仍可能无法解析该目录下类的依赖（尤其涉及 new Xyz() 或 use 语句时）
反之，若一个类在 autoload 中注册了，但所在目录不在 paths 列表里，Deptrac 根本不会读取那个文件，也就不会检查它的层间调用

典型场景：你把领域模型放在 domain/，但 composer.json 没配 "Domain": "domain/"，Deptrac 就无法将 new User() 关联到 DomainUser，导致“未知类”警告或规则漏检。

CI 环境中容易忽略的 Composer 相关陷阱

在 GitHub Actions、GitLab CI 等环境中，Deptrac 往往因 Composer 状态不一致而失败：

composer install --no-dev 后，vendor/autoload.php 不包含 autoload-dev 部分 → Deptrac 扫不到 tests/，但你的规则可能依赖测试层声明（如 TestLayer）
使用 composer install --prefer-dist 通常没问题，但若项目含 path repository（本地包），必须加 --prefer-source，否则 Deptrac 扫描不到 symlink 目录里的源码
多阶段 Docker 构建中，deptrac 运行在不含 composer 命令的轻量镜像里 → 不能指望它现场生成 autoload，必须提前把 vendor/ 和完整 autoload 文件打进镜像