antalaron/git-version

PHP library to get current Git version

v1.4.0 2024-06-04 13:23 UTC

README

Tests

PHP library to get the Git version of the project.

This library does not depend on the Git.

Installation

Open a command console, enter your project directory and execute the following command to download the latest stable version of this library:

$ composer require antalaron/git-version

This command requires you to have Composer installed globally, as explained in the installation chapter of the Composer documentation.

Usage

To get the version:

$gitVersion = new \Antalaron\GitVersion\GitVersion();
$gitVersion->getVersion(__DIR__);

// or static
\Antalaron\GitVersion\GitVersion::getGitVersion(__DIR__);

If no git found, then the return value is null.

There is a second $hashLenght parameter in the methods. With that, you will get the first n character of the hash.

To get the latest commit message:

$gitVersion = new \Antalaron\GitVersion\GitVersion();
$gitVersion->getLatestCommit(__DIR__);

// or static
\Antalaron\GitVersion\GitVersion::getGitLatestCommit(__DIR__);

On error, the return value is null.

To get the latest commit object:

$gitVersion = new \Antalaron\GitVersion\GitVersion();
$gitVersion->getLatestCommitDetails(__DIR__);

// or static
\Antalaron\GitVersion\GitVersion::getGitLatestCommitDetails(__DIR__);

License

This project is under MIT License.