Skip to main content

Ein Übungsprojekt anlegen

Ziel dieses Abschnitts

Bevor du den ersten Befehl git init ausführst, brauchst du eine solide Ausgangsbasis: ein Übungsprojekt, an dem du die folgenden Kapitel gefahrlos durchspielen kannst. Dieses Projekt begleitet dich durch das gesamte vierte Kapitel – vom ersten Commit bis zum Vergleich von IDE- und Kommandozeilen-Workflow. Es lohnt sich daher, den Speicherort und die Struktur bewusst zu wählen, statt „irgendwo" schnell einen Ordner zu erstellen.

Warum ein eigenes Testprojekt sinnvoll ist

Ein separates Übungsprojekt hat mehrere Vorteile gegenüber dem direkten Experimentieren in einem echten Arbeitsprojekt:

  • Risikofreiheit – Fehlerhafte Commits, missglückte Resets oder gelöschte Dateien richten keinen Schaden an produktivem Code an.
  • Wiederholbarkeit – Du kannst den Ordner jederzeit löschen und neu beginnen, wenn du dich „verrannt" hast.
  • Nachvollziehbarkeit – Ein kleines, überschaubares Projekt macht git log, git diff und ähnliche Ausgaben leicht lesbar.
  • Übertragbarkeit – Die hier erlernten Abläufe funktionieren identisch in jedem späteren PHP-Projekt.

Den richtigen Speicherort wählen

Unter Windows 11 gibt es einige Fallstricke, die gerade Einsteiger häufig übersehen. Beachte folgende Punkte bereits vor dem Anlegen des Ordners:

OneDrive vermeiden

Wenn dein Benutzerordner (Dokumente, Desktop) mit OneDrive synchronisiert wird, kann es zu Konflikten zwischen Git und dem Synchronisationsdienst kommen: OneDrive verändert Zeitstempel, sperrt Dateien kurzfristig oder synchronisiert das .git-Verzeichnis unnötig mit in die Cloud. Lege Übungsprojekte daher außerhalb synchronisierter Ordner ab, zum Beispiel direkt unter C:\Users\<Name>\Projekte.

Kurze, einfache Pfade verwenden

Windows hatte historisch ein Limit von 260 Zeichen für Dateipfade. Auch wenn moderne Systeme lange Pfade unterstützen können (siehe Kapitel 2), ist es sinnvoll, tief verschachtelte Pfadstrukturen zu vermeiden. Ein Pfad wie

C:\Projekte\git-uebung

ist deutlich robuster als ein tief verschachtelter Pfad in einem OneDrive- oder Netzlaufwerk-Ordner.

Keine Leerzeichen und Sonderzeichen im Ordnernamen

Leerzeichen, Umlaute oder Sonderzeichen im Projektpfad können in Kombination mit bestimmten Tools (Composer, PHPUnit, CI-Skripten) zu subtilen Fehlern führen. Verwende für den Ordnernamen ausschließlich Kleinbuchstaben, Ziffern und Bindestriche – ganz im Sinne späterer Branch-Namenskonventionen (siehe Kapitel 9).

Projektstruktur planen

Für dieses Kapitel genügt ein sehr einfaches PHP-Projekt. Es soll klein bleiben, aber genügend Dateien enthalten, um sinnvolle Commits, Diffs und Umbenennungen zu demonstrieren:

git-uebung/
├── README.md
├── src/
│   └── Rechner.php
└── tests/
    └── RechnerTest.php
Datei Zweck
README.md Kurzbeschreibung des Übungsprojekts
src/Rechner.php Einfache PHP-Klasse als Beispielcode
tests/RechnerTest.php Platzhalter für spätere Testübungen

Diese Struktur reicht aus, um im weiteren Verlauf des Kapitels Dateien hinzuzufügen, zu ändern, umzubenennen und zu entfernen.

Ordner und Dateien anlegen

Du kannst das Projekt sowohl über die Kommandozeile als auch über den Windows-Explorer anlegen. Für die Konsistenz mit späteren Kapiteln empfiehlt sich der Weg über Git Bash oder PowerShell.

Variante 1: Git Bash

mkdir -p ~/Projekte/git-uebung/src
mkdir -p ~/Projekte/git-uebung/tests
cd ~/Projekte/git-uebung

echo "# Git-Übungsprojekt" > README.md

Variante 2: PowerShell

New-Item -ItemType Directory -Path "C:\Projekte\git-uebung\src" -Force
New-Item -ItemType Directory -Path "C:\Projekte\git-uebung\tests" -Force
Set-Location "C:\Projekte\git-uebung"

"# Git-Übungsprojekt" | Out-File -Encoding utf8 README.md

Hinweis: Achte in PowerShell auf die Kodierung. Git arbeitet intern mit UTF-8; Dateien, die PowerShell standardmäßig in UTF-16 speichert, können später zu unerwarteten Diffs führen (siehe Kapitel 29 zu .gitattributes).

Beispielinhalt für src/Rechner.php

<?php

declare(strict_types=1);

final class Rechner
{
    public function addieren(int $a, int $b): int
    {
        return $a + $b;
    }
}

Beispielinhalt für tests/RechnerTest.php

<?php

declare(strict_types=1);

// Platzhalter für spätere PHPUnit-Übungen.

Diese Dateien sind bewusst einfach gehalten – der Schwerpunkt dieses Kapitels liegt auf Git, nicht auf PHP-Architektur.

Projekt in PhpStorm öffnen

Nachdem die Ordnerstruktur steht, öffnest du sie in PhpStorm, um beide Arbeitswege – Terminal und IDE – parallel nutzen zu können:

  1. Starte PhpStorm und wähle Datei → Öffnen….
  2. Navigiere zum Ordner git-uebung und bestätige mit OK.
  3. Wähle im folgenden Dialog Als vertrauenswürdiges Projekt öffnen, damit PhpStorm Indizierung und Codeanalyse ausführen darf.
  4. Warte, bis die Indizierung abgeschlossen ist – erkennbar am Fortschrittsbalken unten rechts.

Zu diesem Zeitpunkt ist das Projekt noch kein Git-Repository. Das ändert sich erst im nächsten Abschnitt mit git init – bewusst als eigener, klar abgegrenzter Schritt.

Checkliste vor dem nächsten Schritt

Bevor du weiterliest, sollten folgende Punkte erfüllt sein:

  • Projektordner liegt außerhalb von OneDrive oder anderen Cloud-Synchronisationsordnern.
  • Pfad ist kurz, enthält keine Leerzeichen oder Sonderzeichen.
  • Ordnerstruktur mit src/, tests/ und README.md ist vorhanden.
  • Projekt ist in PhpStorm geöffnet und vollständig indiziert.
  • Terminal (Git Bash oder PowerShell) ist im Projektordner geöffnet und einsatzbereit.

Mit dieser Grundlage bist du bereit für den eigentlichen Einstieg: die Initialisierung des Repositories mit git init und einem ersten Blick in das dabei entstehende .git-Verzeichnis.

Back to top