# Filesystem-Komponente mit Lazy-Loading

Diese Komponente bietet eine einfache Abstraktion für Dateisystem-Operationen mit Lazy-Loading-Unterstützung für PHP 8.4.

## Funktionen

- **Abstraktion**: Einheitliches Interface für Dateisystem-Operationen
- **Lazy-Loading**: Optimierte Leistung durch verzögertes Laden von Eigenschaften
- **Testbarkeit**: In-Memory-Implementierung für Tests

## Verwendungsbeispiele

### Beispiel 1: Datei mit Lazy-Loading verwenden

```php
// Storage-Implementierung holen
$storage = new FileStorage();

// Datei-Objekt mit Lazy-Loading erstellen
$file = $storage->file('/pfad/zur/datei.txt');

// Hier passiert noch kein Disk-I/O
echo "Datei: {$file->path}\n";

// Erst hier wird der Inhalt tatsächlich geladen
echo "Inhalt: {$file->contents}\n";

// Und hier die Dateigröße
echo "Größe: {$file->size} Bytes\n";
```

### Beispiel 2: Mit Verzeichnissen arbeiten

```php
// Verzeichnis-Objekt mit Lazy-Loading erstellen
$dir = $storage->directory('/pfad/zum/verzeichnis');

// Verzeichnis erstellen, falls es nicht existiert
if (!$dir->exists()) {
    $dir->create();
}

// Alle Dateien auflisten (lazy geladen)
foreach ($dir->getFiles() as $file) {
    echo "{$file->path}: {$file->size} Bytes\n";
}
```

### Beispiel 3: Dateien kopieren und löschen

```php
$file = $storage->file('/quelle.txt');

// Datei kopieren
$neueFile = $file->copyTo('/ziel.txt');

// Quelldatei löschen
$file->delete();
```

## Technische Details

Die Komponente nutzt die neuen PHP 8.4 Lazy-Loading-Features:

- **ReflectionClass::newLazyProxy()**: Für File-Objekte mit individuellen Property-Callbacks
- **ReflectionClass::newLazyGhost()**: Für Directory-Objekte mit einheitlichem Initializer

Die Properties werden erst geladen, wenn sie tatsächlich verwendet werden, was besonders bei Verzeichnislisten und großen Dateien zu erheblichen Leistungsverbesserungen führt.
