tjvb/githash

Get the current git hash from your project.

Maintainers

Details

gitlab.com/tjvb/githash

Source

Issues

Fund package maintenance!
Paypal

1.1.0 2021-11-30 19:35 UTC

This package is auto-updated.

Last update: 2022-04-29 01:41:12 UTC


README

This package is intended to give a usefull option for getting the hash from the current commit.

Usage

try {
    $retriever = Retriever::getWithFactory(GitHashFinderFactory::withDefaultFinders());
    echo $retriever->getHash($path)->hash() . PHP_EOL;
} catch (GitHashException $exception) {
    echo 'Failed to get the hash ' .  $exception->getMessage() . PHP_EOL;
}

Examples

See docs/examples for examples about how to use this package.

Installation

You can install this package with composer by executing the command: composer require tjvb/githash.

Different HashFinders

The package provide 3 different GitHashFinder they all have some pro's and con's.

GitHashFinderRequirementsBenefitsCons
GitProcessCommandHashFinderThe symfony/process package and git executable.This execute the git commands with the symfony/process package to get good feedback.You need to install this package and have the git command available.
GitShellExecCommandHashFinderThe shell_exec PHP function and git executable.This execute the git commands.You need to have shell_exec and the git command available.
GitFileSystemHashFinderA branch.It reads the git files and doesn't need to have a git executable.The repository need to have a branch, it doesn't work with a detached head.

Laravel package

If you use Laravel you can use tjvb/laravel-githash, this package can add the hash to your log files and provides a blade component to show the hash.

Changelog

We (try to) document all the changes in CHANGELOG so read it for more information.

Contributing

You are very welcome to contribute, read about it in CONTRIBUTING

License

The MIT License (MIT). Please see License File for more information.