sdieunidou/php-git-hooks

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

Git hooks for PHP projects.

v2.0.1 2015-09-01 21:32 UTC

Requires

• php: >=5.5
• fabpot/php-cs-fixer: 1.9.*
• fiunchinho/phpunit-randomizer: 2.0.*
• mockery/mockery: 0.9.*
• mybuilder/phpunit-accelerator: 1.1.*
• phpmd/phpmd: 2.2.*
• phpunit/php-code-coverage: 2.1.*
• phpunit/phpunit: 4.8.*
• phpunit/phpunit-mock-objects: 2.3.*
• squizlabs/php_codesniffer: 2.3.*
• symfony/config: 2.7.*
• symfony/dependency-injection: 2.7.*
• symfony/yaml: 2.7.*

Requires (Dev)

• composer/composer: ~1.0@dev

MIT

• Pablo Braulio

• git
• HOOK
• quality

README

Git hooks for PHP projects

Library based in git hook scripts for PHP projects.

Original scripts

Installation

Step 1: Composer

You must add the following line to the composer.json file:

{
    "require-dev": {
        "bruli/php-git-hooks": "2.*@dev"
    }
}

Or you can write in your console:

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

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

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.

Composer configuration in Symfony2 projects.

In Symfony2 projects you need add this lines in your composer.json:

"scripts": {
    "post-install-cmd": [
      ...other lines...
      "PhpGitHooks\\Application\\Composer\\ConfiguratorScript::buildConfig"
    ],
    "post-update-cmd": [
      ...other lines...
      "PhpGitHooks\\Application\\Composer\\ConfiguratorScript::buildConfig"
    ]

Important: To use 2.X version you need symfony 2.7 version.

Bin directory configuration.

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

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

Note: Not necessary for Symfony projects.

Manual config file for git hooks.

You can configure php-git-hooks, creating a php-git-hooks.yml file with...

pre-commit:
  enabled: true
  execute:
    php-cs-fixer:
        enabled:  true
        level:    psr0
    phpunit:       true
    phplint:       true
    phpcs:         true
    phpmd:         true
commit-msg:
    enabled: true
    regular-expression: '#[0-9]{2,7}'

... or you can copy php-git-hooks.yml.sample from vendor/bruli/php-git-hooks.

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".

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

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.

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.

Step 3: Enabling hooks.

The most easy way to enable hook is copy hook file into your .git/hooks directory.

#For pre-commit hook:

You can enable this hooks with composer or manually executing

 $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

execute.

####Valid pre-commit. ####Fail pre-commit.

Credits

• Pablo Braulio (@brulics)
• All contributors

License

php-git-hooks is released under the MIT License. See the bundled LICENSE file for details.