Download the PHP package butschster/laravel-git-hooks without Composer

Git hooks manager for Laravel application

Laravel Git Hooks manager is a beautiful tools for Laravel applications. It provides a simple and flexible API to manage git hooks, edit commit messages

Features

• Manage git hooks
• Edit commit messages
• Using custom hooks
• Well documented
• Well tested

Requirements

• Laravel 5.6 to 6.x
• PHP 7.2 and above

Installation

From the command line run

composer require --dev butschster/laravel-git-hooks

Register git hooks by running artisan command

php artisan git:register-hooks

That's it!

Configuration

Publish the config file.

php artisan vendor:publish --provider="Butschster\GitHooks\Providers\GitHooksServiceProvider" --tag=config

Hooks

Configuration

You can set list oh hooks for each of type git hook. You can do it in config/git_hooks.php. As a hook you can use class names, service containers and closure functions.

Hook pre-commit

The pre-commit hook is run first, before you even type in a commit message. It’s used to inspect the snapshot that’s about to be committed, to see if you’ve forgotten something, to make sure tests run, or to examine whatever you need to inspect in the code. Exiting non-zero from this hook aborts the commit, although you can bypass it with git commit --no-verify. You can do things like check for code style (run lint or something equivalent), check for trailing whitespace (the default hook does exactly this), or check for appropriate documentation on new methods.

Hook prepare-commit-msg

The prepare-commit-msg hook is run before the commit message editor is fired up but after the default message is created. It lets you edit the default message before the commit author sees it. This hook takes a few parameters: the path to the file that holds the commit message so far, the type of commit, and the commit SHA-1 if this is an amended commit. This hook generally isn’t useful for normal commits; rather, it’s good for commits where the default message is auto-generated, such as templated commit messages, merge commits, squashed commits, and amended commits. You may use it in conjunction with a commit template to programmatically insert information.

Hook commit-msg

The commit-msg hook takes one parameter, which again is the path to a temporary file that contains the commit message written by the developer. If this script exits non-zero, Git aborts the commit process, so you can use it to validate your project state or commit message before allowing a commit to go through.

Hook post-commit

After the entire commit process is completed, the post-commit hook runs. It doesn’t take any parameters, but you can easily get the last commit by running git log -1 HEAD. Generally, this script is used for notification or something similar.