CaptainHook is an easy to use and very flexible git hook library for php developers. It enables you to configure your git hook actions in a simple json file.
You can use CaptainHook to validate your commit messages, ensure code quality or run unit tests before you commit or push changes to git.
You can run cli commands, use some built in validators, or write your own PHP classes that get executed by CaptainHook. For more information have a look at the documentation.
Use Composer to install CaptainHook.
$ composer require --dev captainhook/captainhook
If you want to make sure your whole team uses the same hooks and you want Composer to take care of the hook
installation and activation you should use the CaptainHook composer-plugin
instead.
$ composer require --dev captainhook/plugin-composer
The plugin will make sure that the hooks get activated after every composer install
or update
.
After installing CaptainHook you can use the captainhook executable to create a configuration.
$ vendor/bin/captainhook configure
Now there should be a captainhook.json configuration file.
If you are not using the composer-plugin
you have to activate the hooks manually by installing them to
your local .git repository. To do so just run the following captainhook command.
$ vendor/bin/captainhook install
Have a look at this short installation video.
Here's an example captainhook.json configuration file.
{
"commit-msg": {
"enabled": true,
"actions": [
{
"action": "\\CaptainHook\\App\\Hook\\Message\\Action\\Beams",
"options": []
}
]
},
"pre-commit": {
"enabled": true,
"actions": [
{
"action": "phpunit"
},
{
"action": "phpcs --standard=psr2 src"
}
]
},
"pre-push": {
"enabled": false,
"actions": []
}
}