ecoapm / libyear
软件依赖新鲜度的简单度量
Requires
- php: >=7.4
- ext-json: >=7.4
- composer/semver: 3.3.2
- guzzlehttp/guzzle: 7.5.0
- wp-cli/php-cli-tools: 0.11.16
Requires (Dev)
- mockery/mockery: 1.5.1
- phpunit/phpunit: 9.5.27
README
依赖新鲜度的简单度量
计算所有在 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/libyear
将 libyear
添加为当前目录应用的本地开发依赖项。
替代方案:PHP 归档 (PHAR) 文件
从最新版本下载 libyear.phar
,并将其放置在当前目录中,或者在您的 $PATH
中的某个位置,以便从任何地方引用。
Windows 用户
请注意,Windows 版本的 PHP 不包含 CA 证书,因此如果您尚未安装,则需要安装它们。
- 将 http://curl.haxx.se/ca/cacert.pem 下载到永久位置(PHP 的
extras
目录是一个很好的地方) - 将
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.json
和composer.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
(特别是针对单元测试的 phpunit
和 mockery
)重新安装它们。