navarr/dependency-annotation

为解析 @dependency 注解添加额外功能

资助包维护!
navarr

安装: 17

依赖: 0

建议者: 0

安全: 0

星星: 10

观察者: 3

分支: 0

开放问题: 5

类型:composer-plugin

v2.1.0-alpha.1 2021-07-14 01:15 UTC

README

Latest Stable Version Total Downloads Latest Unstable Version License
Tests Code Coverage Mutation score

此项目提供了一款Composer插件,该插件添加了一个命令(why-block),用于解析PHP #[Dependency] 属性。

如何使用 #[Dependency] 注解

只需在以下格式的任何可注解目标上包含 #[Dependency] 属性

#[Navarr\Attribute\Dependency('package', 'versionConstraint', 'reason')]

此FQN可以导入,在这种情况下,您可以直接使用 #[Dependency(...)]

除了解释之外,所有字段都是必填项。然而,添加解释是强烈建议的。

如何处理不升级composer依赖的原因

如果您正在彻底使用 #[Dependency] 注解,并且您在更新composer依赖时遇到问题,您可以使用命令 composer why-block composer-package version

这将输出包含 composer-package 的 #[Dependency] 注解和无法由指定版本满足的版本约束的文件列表。

如何安装

composer global require navarr/dependency-annotation

与v1的兼容性

为了速度,版本2自动排除旧版 @dependency 注解,转而使用PHP8的 #[Dependency] 属性。在过渡期间,您可以向 why-block 命令指定 -l--include-legacy-annotations 标志,以强制它也处理v1注解。