Was ist Git Interactive Rebase?

Git Interactive Rebase ist ein Werkzeug in Git, mit dem Entwickler die Commit Historie eines Branches gezielt umschreiben, bevor sie in einen geteilten Zweig wie main oder develop gelangt. Statt eine chaotische Abfolge von WIP Commits, Tippfehler Korrekturen und Zwischenständen zu mergen, lässt sich mit git rebase -i eine saubere, logisch nachvollziehbare Commit Kette formen.

Für PHP Entwickler ist Interactive Rebase vor allem in Feature Branches und bei grossen Refactorings relevant, wenn etwa mit Rector automatisierte Umbauten oder mit PHPStan Typsicherheits Verbesserungen durchgeführt werden. Ein klares Git Log ist die Basis für effizientes Code Review, schnelles Debugging mit git bisect und verlässliche Rollbacks.

Im Unterschied zum normalen git rebase, der Commits einfach automatisch auf einen neuen Basis Commit anwendet, öffnet der interaktive Modus einen Editor mit einer Todo Liste. Dort entscheidet der Entwickler Commit für Commit, was passieren soll: behalten, zusammenfassen, umbenennen, aufteilen oder verwerfen.

Ein Interactive Rebase startet mit der Angabe, wie viele Commits bearbeitet werden sollen. Üblich ist ein Bereich ab einem bestimmten Basis Commit oder eine feste Anzahl letzter Commits per HEAD Referenz.

Git öffnet daraufhin den konfigurierten Editor mit einer Todo Liste. Jede Zeile entspricht einem Commit, beginnend mit dem ältesten. Vor jedem Commit steht ein Kommando, standardmässig pick.

Durch Ändern der Kommandos und der Reihenfolge der Zeilen steuert der Entwickler, was mit jedem Commit geschieht. Nach dem Speichern und Schliessen des Editors spielt Git die Commits Schritt für Schritt neu ab und wendet die Anweisungen an. Bei Konflikten pausiert der Rebase, bis manuelle Auflösung erfolgt.

Interactive Rebase kennt eine feste Anzahl an Kommandos, die jedes für sich ein mächtiges Werkzeug darstellen. Das Verständnis dieser sechs Commands deckt rund 95 Prozent aller Praxisfälle ab.

• pick: Commit unverändert übernehmen. Der Default.
• reword: Commit übernehmen, aber die Commit Nachricht im Editor neu schreiben.
• edit: Rebase pausiert vor dem Commit, Änderungen möglich per git commit amend oder zum Splitten in mehrere Commits.
• squash: Commit mit dem vorherigen zusammenfassen, beide Nachrichten werden im Editor kombiniert.
• fixup: Wie squash, aber die Nachricht des aktuellen Commits wird verworfen. Perfekt für Fix Typo Commits.
• drop: Commit komplett entfernen, zum Beispiel temporäre Debug Logs.

Alle Kommandos lassen sich in einer einzigen Todo Liste frei kombinieren. Zusätzlich existieren exec für das Ausführen beliebiger Shell Kommandos zwischen Commits, etwa für automatisierte Tests, sowie break für manuelle Pausen.

Interactive Rebase ist weit mehr als ein Aufräumwerkzeug vor dem Pull Request. In Symfony, Laravel und Sulu Projekten entstehen regelmässig Situationen, in denen eine saubere Commit Historie den Unterschied zwischen schnellem Code Review und stundenlanger Diskussion ausmacht.

Squashen von WIP Commits: Während der Feature Entwicklung sind kleine Zwischenstände hilfreich, im Pull Request aber störend. Per fixup lassen sich fünf oder zehn Zwischen Commits auf einen sauberen Feature Commit reduzieren, ohne dass der Code Reviewer durch Debug Logs und Rücksetzer navigieren muss.

Reordern von Commits: Ein Bug Fix, der während der Feature Arbeit auffällt und direkt committed wurde, gehört logisch vor den eigentlichen Feature Commit. Interactive Rebase erlaubt das einfache Vertauschen durch Umsortieren der Zeilen in der Todo Liste.

Splitten grosser Commits: Wenn ein Commit Refactoring, Bug Fix und neues Feature vermischt, leidet git blame und die Reviewbarkeit. Mit edit und git reset HEAD^ lässt sich ein solcher Commit in mehrere atomare Commits aufteilen.

Rewording von Commit Nachrichten: Commit Nachrichten während der Arbeit sind oft Notizen an das eigene Ich. Vor dem Pull Request lohnt sich der Aufwand, sie in aussagekräftige, issue referenzierte Nachrichten umzuschreiben. Das verbessert git log, git blame und spätere Bisect Suchen.

Entfernen unerwünschter Commits: Temporäre var_dump Aufrufe, auskommentierter Test Code oder versehentlich committete .env Dateien lassen sich per drop aus der Historie entfernen, bevor sie in das geteilte Repository gelangen.

Die wichtigste Regel im Umgang mit Interactive Rebase lautet: Nur private, noch nicht geteilte Commits umschreiben. Sobald ein Branch auf ein Remote gepusht wurde und andere Entwickler darauf aufgebaut haben, führt ein Rebase zu zerstörter Historie für das gesamte Team.

Der Grund: Interactive Rebase erzeugt neue Commit Hashes. Für Git sind die alten und neuen Commits zwei verschiedene Objekte, selbst wenn ihr Inhalt identisch ist. Wer auf Basis der alten Commits gearbeitet hat, bekommt beim nächsten Pull widersprüchliche Historien und muss manuell aufräumen.

Für Solo Feature Branches, die nur der eigenen Synchronisation mit dem Remote dienen, ist ein Rebase nach dem Push vertretbar. Entscheidend ist dann der Einsatz von force with lease statt force.

force with lease prüft vor dem Überschreiben, ob der Remote Branch noch auf dem Stand steht, den Git lokal erwartet. Hat ein Kollege zwischenzeitlich gepusht, schlägt der Push fehl und schützt die Arbeit des Kollegen.

In Legacy PHP Projekten sammeln sich über Jahre chaotische Commit Historien an. Ein Symfony 4 auf Symfony 7 Upgrade mit Rector, ein Austausch des Test Frameworks von PHPUnit zu Pest oder die Migration zu FrankenPHP erzeugen schnell Dutzende kleiner Commits, die ohne Rebase kaum nachvollziehbar sind.

NCA unterstützt PHP Teams dabei, Interactive Rebase als festen Bestandteil des Entwicklungsprozesses zu etablieren. Typische Beratungsschwerpunkte sind:

• Git Workflows definieren: Feature Branches mit Rebase vor Merge, Trunk Based Development oder GitFlow, passend zur Teamgrösse.
• Pre Commit Hooks mit GrumPHP koppeln, damit Code Style, PHPStan und Tests vor jedem Commit laufen.
• CI Pipelines mit PHP Deployer und automatisierter Qualitätssicherung aufbauen, sodass Rebase Workflows und Deployments Hand in Hand gehen.
• Hands on Schulungen zu Rebase, force with lease und Konflikt Auflösung für gemischte Senior und Junior Teams.

Wer seine PHP Entwicklung auf modernes Niveau heben will, profitiert von einer sauberen Git Historie als Fundament. Eine kostenlose Erstberatung zu Git Workflows und PHP Qualitätssicherung in Ihrem Team lässt sich direkt mit Roland Golla vereinbaren: roland@nevercodealone.de oder telefonisch unter +49 176 24747727.

Die folgenden Fragen fassen die häufigsten Stolpersteine rund um Interactive Rebase zusammen, die in PHP Teams regelmässig auftauchen. Vom Team Workflow über Konflikt Auflösung bis zur Integration in Continuous Integration bündelt dieser Abschnitt das Wissen, das im Alltag zählt.