A simple measure of dependency freshness

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

• PHP v7.4 or later
• Composer v2

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.

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.

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 http://curl.haxx.se/ca/cacert.pem 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

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" > 0)

Please be sure to read and follow ecoAPM's Contribution Guidelines 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).