dyweb / php-git-hooks
Git hooks for PHP projects.
Requires
- php: >=5.6
- beberlei/assert: ^2.5
- bruli/event-bus-bundle: ~0.2
- bruli/ignore-files: ~1.0
- bruli/php-value-objects: ~0.1
- fiunchinho/phpunit-randomizer: ~2.0
- friendsofphp/php-cs-fixer: ^1.11
- mockery/mockery: ~0.9
- mybuilder/phpunit-accelerator: ^1.1
- phpmd/phpmd: ~2.2
- phpunit/php-code-coverage: ~3.0|~4.0
- phpunit/phpunit: ~5.0
- phpunit/phpunit-mock-objects: ~3.0
- seld/jsonlint: 1.3.*
- squizlabs/php_codesniffer: ~2.3
- symfony/config: ~2.7|~3.0
- symfony/dependency-injection: ~2.7|~3.0
- symfony/yaml: ~2.7|~3.0
Requires (Dev)
- composer/composer: ^1.0@dev
- fzaninotto/faker: ^1.6
This package is not auto-updated.
Last update: 2024-11-04 15:57:47 UTC
README
Git hooks for PHP projects.
Library based in git hook scripts for PHP projects.
Installation
Step 1: Composer
You must add the following line to the composer.json
file to use with Symfony 3.0:
{ "require-dev": { "dyweb/php-git-hooks": "~4.1" } }
You can use "~2.0" for Symfony version 2.X.
Or you can write in your console:
$ composer require dyweb/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
Using Composer
First, you will need to add the following lines to your composer.json
"scripts": { "post-install-cmd": [ "PhpGitHooks\\Infrastructure\\Composer\\ConfiguratorScript::buildConfig" ], "post-update-cmd": [ "PhpGitHooks\\Infrastructure\\Composer\\ConfiguratorScript::buildConfig" ] }
WARNING: "PhpGitHooks\Application\Composer\ConfiguratorScript::buildConfig" is deprecated. You need change by current entry.
Then, launch $ composer install
and composer should ask you about configuration
Bin directory configuration.
If your project doesn't have a "bin/" directory, you can add this in your composer.json
file.
"config": { "bin-dir": "bin" }
Note: This is 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 levels: psr0: true psr1: true psr2: true symfony: true options: "--fixers=short_array_syntax --diff" phpunit: enabled: true random-mode: true options: '<some options>' strict-coverage: enabled: true minimum: 90 guard-coverage: enabled: true message: 'WARNING!!, your code coverage is lower.' phplint: true phpcs: enabled: true standard: PSR2 phpmd: enabled: true options: '<some options>' composer: true message: right-message: 'HEY, GOOD JOB!!' error-message: 'FIX YOUR CODE!!' commit-msg: enabled: true regular-expression: '#[0-9]{2,7}' pre-push: enabled: true execute: phpunit: enabled: true random-mode: true options: '<some options>' strict-coverage: enabled: true minimum: 90 guard-coverage: enabled: true message: 'WARNING!!, your code coverage is lower.' message: right-message: 'PUSH IT!!' error-message: 'YOU CAN NOT PUSH CODE!!'
... or you can copy php-git-hooks.yml.sample from vendor/bruli/php-git-hooks.
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/src/PhpGitHooks/Infrastructure/Hook/pre-commit .git/hooks
#For commit-msg hook:
$ cp vendor/bruli/php-git-hooks/src/PhpGitHooks/Infrastructure/Hook/commit-msg .git/hooks
#For pre-push hook:
$ cp vendor/bruli/php-git-hooks/src/PhpGitHooks/Infrastructure/Hook/pre-push .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.