Formations — 1 037 leçons en français

Accueil › Git & CI/CD › Les hooks Git

Les hooks Git

Hooks et qualité automatiqueavance

Un hook est un script exécutable que Git lance à un moment précis. Git ne regarde qu'une chose : son code de sortie. Zéro, l'opération continue. Non nul, elle est annulée.

#!/bin/sh
# .git/hooks/pre-commit
if git diff --cached --name-only | grep -q '\.env$'; then
  echo "Refus : un fichier .env est dans l'index."
  exit 1
fi

Rendez-le exécutable, sinon Git l'ignore en silence :

chmod +x .git/hooks/pre-commit

Deux familles

S'exécute sur Contournable Rôle
Client votre machine oui, --no-verify retour rapide, confort
Serveur le dépôt distant non règle réellement imposée

Le problème qui définit tout le reste

.git/hooks est à l'intérieur de .git. Ce répertoire n'est pas versionné et n'est pas cloné. Un hook que vous y posez n'existe que chez vous.

git config core.hooksPath .githooks

Cette option déplace le répertoire des hooks vers un dossier ordinaire, donc versionné, donc partagé. C'est le mécanisme sur lequel reposent tous les outils de gestion de hooks. Il reste une étape manuelle : quelqu'un doit exécuter cette commande après le clone.

Ce qu'un hook client ne fait pas

Il n'empêche rien. git commit --no-verify existe et c'est volontaire : personne ne doit être empêché de sauvegarder son travail par un outil de qualité. Un hook client est un conseil rapide, pas une barrière.

Les termes à connaître

Hook

Un script exécutable que Git lance à un moment précis de son fonctionnement. Si le script sort avec un code non nul, Git interrompt l'opération — c'est tout le mécanisme.

.git/hooks

Le répertoire où Git cherche ses hooks. Il est à l'intérieur de .git, donc jamais versionné et jamais cloné : un hook posé là n'existe que sur votre machine.

core.hooksPath

Option de configuration qui déplace le répertoire des hooks. En la pointant vers un dossier versionné, on rend les hooks partageables — c'est le mécanisme utilisé par tous les outils modernes.

Hook client

Exécuté sur la machine du développeur : pre-commit, commit-msg, pre-push. Contournable par --no-verify, donc conseil plutôt que règle.

Hook serveur

Exécuté sur le dépôt distant à la réception d'une poussée : pre-receive, update, post-receive. Non contournable par le client — c'est la seule barrière réelle.

--no-verify

Drapeau de git commit et git push qui saute les hooks clients concernés. Il existe volontairement : un hook client ne doit jamais empêcher quelqu'un de sauvegarder son travail.

Code de sortie

La seule chose que Git regarde. Zéro : l'opération continue. Non nul : elle est annulée. La sortie standard du hook est affichée à l'utilisateur.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.