Michael Schiemer
3085739e34
- Add `FileOwnership` to encapsulate file owner and group information. - Add `ProcessUser` to represent and manage system process user details. - Enhance ownership matching and debugging with structured data objects. - Include new documentation on file ownership handling and permission improvements. - Prepare infrastructure for enriched error handling in filesystem operations.
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
// 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
// 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
$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.