PHPackages                             bedrockstreaming/libyear - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. bedrockstreaming/libyear

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

bedrockstreaming/libyear
========================

Forked from https://github.com/ecoAPM/php-libyear

2.1.0(3y ago)0511PHPPHP &gt;=7.4

Since Jan 22Pushed 3y agoCompare

[ Source](https://github.com/BedrockStreaming/php-libyear)[ Packagist](https://packagist.org/packages/bedrockstreaming/libyear)[ RSS](/packages/bedrockstreaming-libyear/feed)WikiDiscussions main Synced today

READMEChangelog (1)Dependencies (5)Versions (7)Used By (0)

php-libyear
===========

[](#php-libyear)

A simple measure of dependency freshness

[![Version](https://camo.githubusercontent.com/d959ff765c49c4efcb354f652d00b1fa31b7c7e2243eaee3465e4a793a1ee6ff/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f65636f61706d2f6c6962796561723f6c6f676f3d7061636b6167697374266c6162656c3d496e7374616c6c)](https://packagist.org/packages/ecoAPM/libyear)[![CI](https://github.com/ecoAPM/php-libyear/workflows/CI/badge.svg)](https://github.com/ecoAPM/php-libyear/actions)[![Coverage](https://camo.githubusercontent.com/9abdb3f612ff4e9205d26c21f6d701f7a574e160092aea570e87269c37377b06/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d65636f41504d5f7068702d6c696279656172266d65747269633d636f766572616765)](https://sonarcloud.io/dashboard?id=ecoAPM_php-libyear)

[![Maintainability Rating](https://camo.githubusercontent.com/630555404f1150f808b871300982fd75d03c70fcb58d96582e2360708ba75f91/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d65636f41504d5f7068702d6c696279656172266d65747269633d7371616c655f726174696e67)](https://sonarcloud.io/dashboard?id=ecoAPM_php-libyear)[![Reliability Rating](https://camo.githubusercontent.com/42d63f81dc83b3de90d4f86c54fbf4d980888878a0cb820141bfb37a6af94f87/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d65636f41504d5f7068702d6c696279656172266d65747269633d72656c696162696c6974795f726174696e67)](https://sonarcloud.io/dashboard?id=ecoAPM_php-libyear)[![Security Rating](https://camo.githubusercontent.com/92e5a9bbb514c0ceef8171b7993cc3965f466f9bd886d35a53f81e35ef205419/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d65636f41504d5f7068702d6c696279656172266d65747269633d73656375726974795f726174696e67)](https://sonarcloud.io/dashboard?id=ecoAPM_php-libyear)

Calculates the total number of years behind their respective newest versions for all dependencies listed in `composer.json`.

Requirements
------------

[](#requirements)

- PHP v7.4 or later
- Composer v2

Installation
------------

[](#installation)

### Recommended: Composer

[](#recommended-composer)

Run `composer global require ecoapm/libyear` and make sure your global composer directory is in your `$PATH`.

Alternatively, `composer require --dev ecoapm/libyear` will add `libyear` as a local dev dependency for your current directory's app.

### Alternative: PHP Archive (PHAR) File

[](#alternative-php-archive-phar-file)

Download `libyear.phar` from the latest release, and put it in the current directory, or somewhere in your `$PATH` to be able to reference it from anywhere.

### Windows Users

[](#windows-users)

Note that PHP for Windows does not include CA certificates, so you'll need to install them if you haven't done so already:

1. Download  to somewhere permanent (PHP's `extras` directory is a great place)
2. Add `curl.cainfo = "[full path to]\cacert.pem"` to your `php.ini` file

Usage
-----

[](#usage)

`vendor/bin/libyear { path to project } [-q]`

(or `php path/to/libyear.phar { path to project } [-q]` for the PHAR version)

Arguments:

- `path to project`: required, directory containing `composer.json` and `composer.lock` files
- `-q`: optional, quiet mode will only output libraries which are not up-to-date (that is, where "Libyears Behind" &gt; 0)

### Limitations

[](#limitations)

- Currently only packages listed on Packagist are supported (feel free to submit a PR for issue #1)

Contributing
------------

[](#contributing)

Please be sure to read and follow ecoAPM's [Contribution Guidelines](CONTRIBUTING.md) when submitting issues or pull requests.

When testing new features and bug fixes, you can run the script via `./libyear { path } [-q]` before building the `phar` file.

To build the `phar` file for final manual testing, run `php -dphar.readonly=0 build.php`. You may wish to run `composer install --no-dev` first to speed up the build process by removing dev dependencies, but will need to reinstall them via `composer install` (specifically, `phpunit` and `mockery` for unit testing).

###  Health Score

29

—

LowBetter than 57% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity12

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity62

Established project with proven stability

 Bus Factor1

Top contributor holds 52.1% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~241 days

Total

5

Last Release

1390d ago

Major Versions

1.0.0 → 2.0.02021-09-15

PHP version history (2 changes)1.0.0PHP ^7.4

2.0.0PHP &gt;=7.4

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/2069361?v=4)[Patrick](/maintainers/Bedrock)[@Bedrock](https://github.com/Bedrock)

---

Top Contributors

[![SteveDesmond-ca](https://avatars.githubusercontent.com/u/195896?v=4)](https://github.com/SteveDesmond-ca "SteveDesmond-ca (25 commits)")[![SteamDragonLady](https://avatars.githubusercontent.com/u/43454064?v=4)](https://github.com/SteamDragonLady "SteamDragonLady (15 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (3 commits)")[![cyril-flieller](https://avatars.githubusercontent.com/u/10221012?v=4)](https://github.com/cyril-flieller "cyril-flieller (2 commits)")[![faby-nikson](https://avatars.githubusercontent.com/u/41300473?v=4)](https://github.com/faby-nikson "faby-nikson (2 commits)")[![greg0ire](https://avatars.githubusercontent.com/u/657779?v=4)](https://github.com/greg0ire "greg0ire (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/bedrockstreaming-libyear/health.svg)

```
[![Health](https://phpackages.com/badges/bedrockstreaming-libyear/health.svg)](https://phpackages.com/packages/bedrockstreaming-libyear)
```

###  Alternatives

[craftcms/cms

Craft CMS

3.6k3.6M3.1k](/packages/craftcms-cms)[statamic/cms

The Statamic CMS Core Package

4.8k3.6M986](/packages/statamic-cms)[drupal/core

Drupal is an open source content management platform powering millions of websites and applications.

21866.0M1.7k](/packages/drupal-core)[drupal/core-recommended

Locked core dependencies; require this project INSTEAD OF drupal/core.

6942.5M421](/packages/drupal-core-recommended)[pantheon-systems/terminus

A command line interface for Pantheon

3391.5M18](/packages/pantheon-systems-terminus)[symfony/asset-mapper

Maps directories of assets &amp; makes them available in a public directory with versioned filenames.

1678.8M237](/packages/symfony-asset-mapper)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
