2017 © Pedro Peláez

library php-git-hooks

Git hooks for PHP projects.



Git hooks for PHP projects.

  • Thursday, December 17, 2015
  • by joshhornby
  • Repository
  • 1 Watchers
  • 0 Stars
  • 6 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 96 Forks
  • 0 Open issues
  • 18 Versions
  • 0 % Grown



Build Status Scrutinizer Code Quality Code Coverage Latest Stable Version Total Downloads Latest Unstable Version License SensioLabsInsight, (*1)

Git hooks for PHP projects., (*2)

Library based in git hook scripts for PHP projects., (*3)

Original scripts, (*4)


Step 1: Composer

You must add the following line to the composer.json file:, (*5)

    "require-dev": {
        "bruli/php-git-hooks": "^2.0"

Or you can write in your console:, (*6)

$ composer require bruli/php-git-hooks --dev

If you don't have composer, you need download the binary file and run it:, (*7)

wget http://getcomposer.org/composer.phar
# or
curl -O http://getcomposer.org/composer.phar

php composer.phar install

Step 2: Configuration

Composer configuration.

After download all repositories, composer ask you about configuration., (*8)

, (*9)

Composer configuration in Symfony2 projects.

In Symfony2 projects you need add this lines in your composer.json:, (*10)

"scripts": {
    "post-install-cmd": [
      ...other lines...
    "post-update-cmd": [
      ...other lines...

Important: To use 2.X version you need symfony 2.7 version., (*11)

Bin directory configuration.

If your project haven't a "bin" directory, you can add this in your compose.json file., (*12)

 "config": {
        "bin-dir": "bin"

Note: Not necessary for Symfony projects., (*13)

Manual config file for git hooks.

You can configure php-git-hooks, creating a php-git-hooks.yml file with..., (*14)

  enabled: true
        enabled:  true
            psr0:       true
            psr1:       true
            psr2:       true
            symfony:    true
        enabled:     true
        random-mode: true
    phplint:         true
        enabled:     true
        standard:    PSR2
    phpmd:           true
    composer:        true
    enabled: true
    regular-expression: '#[0-9]{2,7}'

... or you can copy php-git-hooks.yml.sample from vendor/bruli/php-git-hooks., (*15)

Update from v1.3.*

Php-cs-fixer configuration in php-git-hooks.yml file, is not compatible with 2.0 version. You should remove php-cs-fixer entry and execute "composer install"., (*16)

Most easy way to update is delete php-git-hooks.yml and execute "composer install". You will see all the configuration questions again., (*17)

Config file for phpunit.

If you want use phpunit tool, you must create a phpunit.xml.dist in your project root directory. Alternatively you can copy from vendor/bruli/php-git-hooks/phpunit.xml.dist in your project root directory., (*18)

Config file for phpmd.

The same case that phpunit. You must create a PmdRules.xml in your project root directory or copy from php-git-hook directory., (*19)

Step 3: Enabling hooks.

The most easy way to enable hook is copy hook file into your .git/hooks directory., (*20)

For pre-commit hook:

You can enable this hooks with composer or manually executing, (*21)

 $cp vendor/bruli/php-git-hooks/hooks/pre-commit .git/hooks

For commit-msg hook:

 $cp vendor/bruli/php-git-hooks/hooks/commit-msg .git/hooks


Valid pre-commit.

, (*22)

Fail pre-commit.

, (*23)



php-git-hooks is released under the MIT License. See the bundled LICENSE file for details., (*24)

The Versions