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:
Starte PhpStorm und wähle Datei → Öffnen….
Navigiere zum Ordner 
git-uebung und bestätige mit OK.
Wähle im folgenden Dialog Als vertrauenswürdiges Projekt öffnen, damit PhpStorm Indizierung und Codeanalyse ausführen darf.
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.