Add PHP Media API scaffold and Docker configs

Initial project scaffold for a PHP Media API including routing, controllers, models and services under api/ (Router, Media/Cast/Image/Settings controllers, models, database/bootstrap files and automatic docs service). Adds Docker support (Dockerfile, docker-compose.yml, DOCKER_README.md, php-custom.ini), .htaccess for pretty URLs, API documentation and example payloads (API_EXAMPLES.md, api/README.md, api_examples/*.json), image handling service and logging, plus a comprehensive .gitignore. This commit provides a runnable development environment and example requests to get the API up and tested quickly.
2026-04-12 00:46:30 +02:00
commit 66f69bc90d
54 changed files with 6035 additions and 0 deletions
--- a/api/models/Music.php
+++ b/api/models/Music.php
@@ -0,0 +1,112 @@
+<?php
+
+require_once __DIR__ . '/MediaType.php';
+
+class Music extends MediaType {
+    protected function getType() {
+        return 'Album';
+    }
+    
+    protected function getTypeSpecificFields() {
+        return ['artist', 'album_type', 'release_date'];
+    }
+    
+    protected function validateTypeSpecificFields($data) {
+        // Music spezifische Validierung
+    }
+    
+    public function search($filters = [], $page = 1, $limit = 20) {
+        // Nur Music suchen
+        $filters['type'] = 'Album';
+        return parent::search($filters, $page, $limit);
+    }
+    
+    public function getWithTracks($id) {
+        $media = $this->getWithRelations($id);
+        if (!$media) {
+            return null;
+        }
+        
+        $media['tracks'] = $this->getTracks($id);
+        
+        return $media;
+    }
+    
+    public function getTracks($mediaId) {
+        $stmt = $this->pdo->prepare("
+            SELECT * FROM tracks WHERE media_id = ? ORDER BY track_number
+        ");
+        $stmt->execute([$mediaId]);
+        return $stmt->fetchAll();
+    }
+    
+    public function addTrack($mediaId, $trackData) {
+        $stmt = $this->pdo->prepare("
+            INSERT INTO tracks (media_id, track_number, title, artist)
+            VALUES (?, ?, ?, ?)
+        ");
+        $stmt->execute([
+            $mediaId,
+            $trackData['track_number'] ?? null,
+            $trackData['title'] ?? null,
+            //$trackData['duration'] ?? null,
+            $trackData['artist'] ?? null
+        ]);
+        return $this->pdo->lastInsertId();
+    }
+    
+    public function updateTrack($trackId, $trackData) {
+        $fields = [];
+        $params = [];
+        
+        foreach (['track_number', 'title', 'artist'] as $field) {
+            if (array_key_exists($field, $trackData)) {
+                $fields[] = "$field = ?";
+                $params[] = $trackData[$field];
+            }
+        }
+        
+        if (!empty($fields)) {
+            $params[] = $trackId;
+            $stmt = $this->pdo->prepare("UPDATE tracks SET " . implode(', ', $fields) . " WHERE id = ?");
+            $stmt->execute($params);
+            return true;
+        }
+        return false;
+    }
+    
+    public function deleteTrack($trackId) {
+        $stmt = $this->pdo->prepare("DELETE FROM tracks WHERE id = ?");
+        $stmt->execute([$trackId]);
+        return $stmt->rowCount() > 0;
+    }
+    
+    public function createWithRelations($data) {
+        $mediaId = parent::createWithRelations($data);
+        
+        // Tracks speichern
+        if (isset($data['tracks']) && is_array($data['tracks'])) {
+            foreach ($data['tracks'] as $track) {
+                $this->addTrack($mediaId, $track);
+            }
+        }
+        
+        return $mediaId;
+    }
+    
+    public function updateWithRelations($id, $data) {
+        parent::updateWithRelations($id, $data);
+        
+        // Tracks aktualisieren
+        if (isset($data['tracks']) && is_array($data['tracks'])) {
+            // Alle existierenden Tracks löschen
+            $this->pdo->prepare("DELETE FROM tracks WHERE media_id = ?")->execute([$id]);
+            // Neue Tracks hinzufügen
+            foreach ($data['tracks'] as $track) {
+                $this->addTrack($id, $track);
+            }
+        }
+        
+        return true;
+    }
+}