This package is abandoned and no longer maintained. No replacement package was suggested.

A simple laravel package for adding custom git hooks to your laravel projects. Ships with phpunit, phpcs, and eslint

v0.5.1 2018-04-01 19:13 UTC


Laravel Git Hooks

This is a community project and not an "official" Laravel one

Latest Stable Version Total Downloads License Build Status

This package provides a way to add custom git hooks to your laravel project. Easily configure any command to be fired throughout the git-hook process. Want to ensure that all tests pass before a bad commit is pushed? Now's your chance!

Currently, the following git hooks are supported:

  • pre-commit
  • prepare-commit-msg
  • pre-push
  • post-checkout


Via Composer

$ composer require mr-feek/laravel-git-hooks --dev

Edit your laravel project's composer.json so that these hooks are installed for every developer after they use composer.

"post-autoload-dump": [
    "@php artisan hooks:install"


  • Publish this package's configuration file: php artisan vendor:publish --provider="Feek\LaravelGitHooks\LaravelGitHooksServiceProvider"
  • Register specific artisan commands to be run in the configuration array. For example, all commands nested within the pre-commit array key will be run prior to a git commit. All commands nested within the pre-push array key will be run prior to a git push. If any of these registered commands fail, then the git action will be prevented.
return [
    'commit-msg' => [
    'pre-commit' => [
        'php artisan hooks:phpcs --diff --proxiedArguments="-p -n --standard=PSR2"',
        'php artisan hooks:eslint --diff --proxiedArguments="--fix --quiet"',
    'pre-push' => [
    'post-checkout' => [
        'php artisan hooks:install-deps'
    'prepare-commit-msg' => [
        'php artisan hooks:semantic-commits',


This package ships with several handy artisan commands which work nicely as git hooks. The following commands come included:

  • phpcs
  • phpcbf
  • phpstan
  • install dependencies (composer, yarn, npm)
  • eslint
  • semantic commit messages

Sniffer Commands

The PHPCS, PHPCBF, PHPSTAN, and ESLINT commands all allow you to pass arguments to the underlying process being executed. You can utilize this via the --proxiedArguments flag. In the code examples above, the following phpcs command will be executed: phpcs -p -n --standard=PSR2

Supported Versions Of Laravel

Laravel ^5.5 is actively supported. Need support for earlier versions of Laravel? Feel free to open a PR

Change log

Please see CHANGELOG for more information on what has changed recently.


Please see CONTRIBUTING and CODE_OF_CONDUCT for details.

Wondering how to go about working on a laravel package? See and



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