ecoapm/libyear

软件依赖新鲜度的一个简单度量

2.3.0 2022-12-15 21:07 UTC

This package is auto-updated.

Last update: 2024-09-23 12:13:59 UTC


README

依赖新鲜度的简单度量

Version CI Coverage

Maintainability Rating Reliability Rating Security Rating

计算所有列在 composer.json 中的依赖项相对于它们各自最新版本的年份差距总和。

要求

  • PHP v7.4 或更高版本
  • Composer v2

注意,2.3.0 是最后一个支持 PHP 7.4 和 8.0 的版本;v3(预计 2023 年第三季度发布)将仅支持 PHP 8.1+。

对于 企业、高级和称号赞助商,可以提供对 PHP 旧版本的持续商业支持。

安装

推荐:Composer

运行 composer global require ecoapm/libyear 并确保您的全局 Composer 目录在您的 $PATH 中。

或者,使用 composer require --dev ecoapm/libyearlibyear 添加为当前目录应用的本地开发依赖项。

备选方案:PHP 归档(PHAR)文件

从最新版本中下载 libyear.phar,并将其放置在当前目录或 $PATH 中的某个位置,以便在任何地方引用它。

Windows 用户

请注意,Windows 版本的 PHP 不包括 CA 证书,因此如果您尚未安装,您需要安装它们

  1. http://curl.haxx.se/ca/cacert.pem 下载到永久位置(PHP 的 extras 目录是一个很好的地方)
  2. curl.cainfo = "[full path to]\cacert.pem" 添加到您的 php.ini 文件中

用法

vendor/bin/libyear <path> [-q|--quiet] [-v|--verbose]

(或 php path/to/libyear.phar <path> [-q|--quiet] [-v|--verbose] 用于 PHAR 版本)

参数

  • path: 必选,包含 composer.jsoncomposer.lock 文件的目录

选项

  • -h, --help: 显示帮助文本并退出,不检查依赖项
  • -q, --quiet: 静默模式将仅输出未更新的库(即“落后年份”大于 0 的库)
  • -u, --update: 更新模式将最新版本信息写入您的 composer.json 文件(请注意,您仍然需要运行 composer update 来实际更新您的本地依赖项)
  • -v, --verbose: 详细模式将输出处理细节,如库在存储库中未找到时

贡献

请在提交问题或拉取请求时务必阅读和遵循 ecoAPM 的 贡献指南

在测试新功能和错误修复时,您可以在构建 phar 文件之前通过 ./libyear { path } [-q] 运行脚本。

要为最终手动测试构建 phar 文件,请运行 php -dphar.readonly=0 build.php。您可能希望首先运行 composer install --no-dev 以通过删除开发依赖项来加速构建过程,但需要通过 composer install 重新安装它们(特别是单元测试的 phpunitmockery)。