Skip to main content

Dein erster Commit in PhpStorm – Schritt für Schritt 🎉

Du hast dein Projekt als Git-Repository initialisiert und möglicherweise schon eine .gitignore-Datei angelegt. Jetzt wird es Zeit, deinen ersten Commit zu machen – also einen Schnappschuss deines aktuellen Projektstands in der Git-Historie zu speichern.

Der Ablauf im Überblick

Bevor wir in die Details gehen, hier der grundsätzliche Prozess:

flowchart LR
    A["1. Dateien bearbeiten\nim Working Directory"] --> B["2. Dateien zur\nStaging Area hinzufuegen"]
    B --> C["3. Commit erstellen\nmit Nachricht"]
    C --> D["4. Aenderung ist\nin der Historie"]

In PhpStorm ist dieser Prozess besonders komfortabel, weil du alles in einer einzigen Oberfläche erledigen kannst.

Schritt-für-Schritt-Anleitung

  1. Das Commit-Fenster öffnen

    Es gibt mehrere Wege, das Commit-Fenster zu öffnen:

    • Tastenkürzel: Strg + K (Windows/Linux) bzw. Cmd + K (macOS) – der schnellste Weg
    • Menü: Gehe zu Git → Commit…
    • Toolbar: Klicke auf das grüne Häkchen-Symbol in der oberen Symbolleiste

    Es öffnet sich links (oder als separates Fenster, je nach Einstellung) das Commit-Tool-Window.

  2. Dateien für den Commit auswählen

    Im Commit-Fenster siehst du eine Liste aller Dateien, die sich seit dem letzten Commit geändert haben. Diese sind in Kategorien unterteilt:

    • Unversioned Files: Neue Dateien, die Git noch nicht kennt (rot markiert)
    • Modified Files: Bereits getrackte Dateien, die du verändert hast (blau markiert)
    • Deleted Files: Dateien, die gelöscht wurden

    💡 Tipp: Bei deinem allerersten Commit werden alle Dateien als „Unversioned" angezeigt, weil Git sie noch nie gesehen hat.

    So wählst du Dateien aus:

    • Setze ein Häkchen vor jede Datei, die du in diesen Commit aufnehmen möchtest
    • Um alle Dateien auszuwählen, klicke auf das Häkchen ganz oben bei „Changes" oder „Unversioned Files"
    • Du kannst auch einzelne Dateien gezielt ein- oder ausschließen

    PhpStorm zeigt dir bei jeder Datei eine Vorschau der Änderungen (Diff), wenn du sie anklickst. So kannst du nochmal prüfen, was genau du committen wirst.

  3. Eine aussagekräftige Commit-Nachricht schreiben

    Unterhalb der Dateiliste findest du ein Textfeld mit dem Platzhalter „Commit Message". Hier beschreibst du, was du geändert hast und warum.

    Für deinen ersten Commit ist eine einfache Nachricht völlig in Ordnung, zum Beispiel:

    Initial commit: Projektstruktur angelegt

    oder etwas ausführlicher:

    Erstes Commit: Grundlegende PHP-Dateien und Konfiguration hinzugefügt

    📝 Best Practice: Schreibe die Nachricht so, dass du (oder andere) in drei Monaten noch verstehst, was dieser Commit enthält. Mehr dazu später im Kurs bei den Best Practices.

  4. Optionale Einstellungen prüfen

    Unter dem Nachrichtenfeld findest du einige Optionen, die du für den Anfang meist ignorieren kannst:

    • Amend commit: Fügt Änderungen zum letzten Commit hinzu (für Anfänger erstmal nicht relevant)
    • Author: Zeigt deinen konfigurierten Namen und E-Mail – sollte bereits korrekt sein
    • Before Commit: Hier kannst du automatische Prüfungen aktivieren (z. B. Code-Analyse, Reformatierung)

    Für deinen ersten Commit kannst du diese Optionen auf den Standardeinstellungen belassen.

  5. Den Commit abschließen

    Wenn du mit deiner Dateiauswahl und Nachricht zufrieden bist, klicke auf den Commit-Button unten im Fenster.

    ⚠️ Hinweis: Du siehst möglicherweise auch einen Button „Commit and Push". Dieser würde den Commit direkt auf einen Remote-Server (z. B. GitHub) hochladen. Da du noch kein Remote-Repository eingerichtet hast, wähle zunächst nur „Commit".

    PhpStorm zeigt dir kurz eine Bestätigung an, z. B.:

    1 file committed: Initial commit: Projektstruktur angelegt

Nach dem Commit: Überprüfen, ob alles geklappt hat

Um sicherzugehen, dass dein Commit erfolgreich war, kannst du die Git-Historie in PhpStorm öffnen:

  • Gehe zu Git → Show Git Log (oder klicke unten auf den Tab „Git" und dann auf „Log")
  • Du siehst jetzt eine Liste aller Commits – bei deinem ersten Commit natürlich nur einen einzigen Eintrag
  • Klickst du auf den Commit, zeigt dir PhpStorm an, welche Dateien enthalten sind und was geändert wurde

Zusammenfassung des Prozesses

Schritt Aktion Tastenkürzel
Commit-Fenster öffnen Git → Commit… Strg/Cmd + K
Dateien auswählen Häkchen setzen –
Nachricht schreiben Im Textfeld eingeben –
Commit abschließen Auf „Commit" klicken –
Historie prüfen Git → Show Git Log Alt + 9

Was passiert eigentlich im Hintergrund? 🔍

Wenn du in PhpStorm auf „Commit" klickst, führt PhpStorm im Hintergrund zwei Git-Befehle aus:

git add <ausgewählte-dateien>
git commit -m "Deine Commit-Nachricht"

Der erste Befehl verschiebt die Dateien in die Staging Area, der zweite erstellt den eigentlichen Commit im Repository. PhpStorm fasst diese beiden Schritte für dich zusammen, sodass du sie nicht einzeln ausführen musst – aber es ist gut zu wissen, was „unter der Haube" passiert.

Du hast jetzt deinen ersten Commit erstellt! 🎊 Ab jetzt kannst du jederzeit weitere Änderungen machen und neue Commits erstellen – und dabei immer auf frühere Versionen zurückgreifen, falls nötig.

Back to top