Support

phpFK Email-Support: Dein direkter Draht zum phpFK-Framework-Support

Herzlich willkommen beim phpFK Email-Support! Auf dieser Seite erfährst du alles Wichtige rund um unseren Support für das phpFK-Framework. Wir beschreiben, welche Themen wir im Rahmen des E-Mail-Supports bearbeiten, wie du deine Anfragen optimal strukturierst und was du für eine zügige Bearbeitung vorbereiten solltest. Dieser Text bezieht sich ausschließlich auf den E-Mail-Support für das phpFK-Framework und soll keine inhaltlichen Überschneidungen mit anderen Seiten erzeugen.

1. Was ist das phpFK-Framework?

Bevor du eine Support-Anfrage stellst, ist es sinnvoll, kurz zu wissen, worum es beim phpFK-Framework geht. Das phpFK-Framework ist ein eigenentwickeltes PHP-Framework von Frank Karau, das insbesondere für kleine und mittlere Webanwendungen konzipiert wurde. Zu den zentralen Merkmalen gehören:

  • Modulare Architektur mit klaren Strukturen für Controller, Models und Views
  • Einfache Konfiguration über Konfigurationsdateien
  • Integriertes Routing-System
  • Unterstützung für Datenbankzugriffe, Session-Handling und Template-Engines
  • Minimaler Overhead und schnelle Ausführung

Wenn du mit dem phpFK-Framework arbeitest und auf technische Fragen oder Probleme stößt, ist der E-Mail-Support der schnellste Weg, um Hilfestellung von den Entwicklern zu bekommen.

2. Welche Themen deckt der phpFK Email-Support ab?

Unser E-Mail-Support befasst sich ausschließlich mit Fragestellungen rund um das phpFK-Framework. Folgende Bereiche sind typische Themen, die wir per E-Mail beantworten:

  • Installation und Setup des phpFK-Frameworks
    • Vorbereitung der Verzeichnisstruktur
    • Anpassen der Konfigurationsdateien (z. B. 
      config/app.php

      ,

      config/db.php

      )

    • Einrichtung von Autoloading und Namespaces
    • Serveranforderungen (PHP-Version, benötigte Extensions)
  • Routing und Controller-Erstellung
    • Definition von Routen in der Datei 
      routes/web.php
    • Erstellen und Konfigurieren von Controller-Klassen
    • Übergabe von Parametern über URL-Pattern
  • Modelle und Datenbankanbindung
    • Konfiguration der Datenbankverbindung in 
      config/db.php
    • Erstellen von Model-Klassen für CRUD-Operationen
    • Verwendung des eingebauten Query-Builders
    • Migrationen und Schema-Definition
  • View-Templates und Template-Engine
    • Einbindung von View-Dateien (z. B. 
      views/header.php

      ,

      views/footer.php

      )

    • Variablenübergabe vom Controller in die Views
    • Arbeiten mit eingebauten Helper-Funktionen (z. B. 
      url()

      ,

      asset()

      )

  • Sessions, Cookies und Middleware
    • Initialisierung und Verwaltung von Sessions
    • Erstellen eigener Middleware-Klassen
    • Implementierung von Authentifizierung und Rollenverwaltung
  • Fehlerbehebung und Debugging
    • Analyse von Exceptions und Stack-Traces
    • Aktivieren des Debug-Modus in 
      config/app.php
    • Verwendung von Logging-Funktionen ( 
      log_debug($message)

      ,

      log_error($message)

      )

  • Performance-Tuning
    • Caching-Mechanismen (z. B. Page-Caching, Query-Caching)
    • Optimierung von Datenbankabfragen
    • Minimierung von HTTP-Requests und Asset-Management
  • Updates und Migrationen
    • Aktualisieren des phpFK-Frameworks auf neuere Versionen
    • Anpassen von Konfigurationsdateien an neue Versionen
    • Datenbank-Migrationen mit dem eingebauten Migrations-Tool

Falls du Fragen zu anderen PHP-Frameworks oder generelle PHP-Themen hast, können wir dir in diesem Rahmen leider nicht weiterhelfen. Konzentriere dich bitte auf das phpFK-Framework, damit wir deine Anfrage schnell und gezielt beantworten können.

3. Wie strukturierst du deine Support-Anfrage?

Eine strukturierte Anfrage hilft uns, dein Anliegen ohne Rückfragen zu bearbeiten. Befolge bitte die folgende Gliederung:

  1. Betreffzeile
    Formuliere kurz und prägnant, worum es geht, z. B.:
    „phpFK: Controller lädt keine Daten aus Datenbank“
  2. Kurze Beschreibung deines Ziels
    In ein bis zwei Sätzen erklärst du, was du erreichen willst, z. B.:
    „Ich möchte in meinem Controller eine Liste von Datensätzen aus der Tabelle `users` anzeigen.“
  3. Rahmendaten
    Liste hier die wichtigsten Eckdaten auf:

    • phpFK-Version (z. B. 2.3.1)
    • PHP-Version (z. B. 8.1.0)
    • Datenbanktyp und -version (z. B. MySQL 5.7, MariaDB 10.4)
    • Webserver (Apache 2.4, Nginx 1.18 – inkl. PHP-FPM, falls verwendet)
    • Betriebssystem (z. B. Ubuntu 20.04, Windows Server 2019)
  4. Schritte zur Reproduktion
    Beschreibe möglichst genau, wie wir dein Problem nachstellen können. Beispiel:

    1. Lege ein neues Controller-File an unter 
      app/Controllers/UserController.php

      .

    2. Füge folgende Methode ein: 
      public function index()
{
    $users = $this->model('UserModel')->getAll();
    $this->view('users/index', ['users' => $users]);
}
    3. Erstelle im Model-Ordner eine Model-Klasse unter 
      app/Models/UserModel.php

      mit dieser Methode:

      public function getAll()
{
    return $this->db->table('users')->get()->result();
}
    4. Rufe die Route im Browser auf: http://deine-domain.de/users.
    5. Es erscheint eine leere Seite ohne Fehlermeldung.
  5. Fehlerausgaben und Logs
    Füge relevante Ausschnitte aus folgenden Dateien bei:

    • php-Fatal-Error oder Exception-Trace aus dem Browser (falls sichtbar).
    • Log-Datei aus dem Verzeichnis 
      storage/logs/error.log

      (nur die relevanten Zeilen).

    • Gegebenenfalls Entwickler-Log-Ausgaben ( 
      log_debug()

      oder

      log_error()

      ).

  6. Konfigurationsdateien
    Poste nur die relevanten Abschnitte aus:

    • config/app.php

      (z. B. Debug-Modus, Base-URL)

    • config/db.php

      (Datenbankzugangsdaten)

    • Eventuell aus 
      config/routes.php

      , falls du eine spezielle Route definiert hast.

  7. Bereits unternommene Lösungsversuche
    Beschreibe kurz, was du bereits ausprobiert hast:

    • Debug-Modus aktiviert ( 
      'debug' => true

      in

      config/app.php

      )

    • Model oder Controller neu registriert und Cache geleert ( 
      php fk cache:clear

      )

    • Datenbankverbindung separat getestet (z. B. mit PHP-Skript oder Admin-Tool)
  8. Deine Wunschlösung
    Erläutere, welches Verhalten du erwartest. Beispiel:
    „Ich möchte, dass die Methode `getAll()` ein Array mit allen Datensätzen ausgibt und diese in der View `users/index.php` angezeigt werden.“

Je vollständiger du diese Punkte bereitstellst, desto schneller und zielgerichteter können wir deine Anfrage bearbeiten.

4. Bearbeitungsprozess im E-Mail-Support

Nachdem du deine Anfrage abgeschickt hast, durchläuft sie bei uns folgende Schritte:

  1. Eingangskontrolle
    Deine E-Mail wird automatisch im Ticketsystem erfasst. Wir prüfen, ob alle notwendigen Informationen (siehe Abschnitt 3) enthalten sind. Fehlen Details, erhältst du zunächst eine Kurz-Rückfrage.
  2. Erste technische Einschätzung
    Ein Entwickler liest deine Anfrage und beurteilt, wie er das Problem nachstellen kann. Dabei klären wir, ob eine lokale Testumgebung notwendig ist oder ob es sich um einen bekannten Fehler handelt.
  3. Reproduktion in Testumgebung
    Falls nötig, legen wir in einer Testumgebung eine minimale Installation des phpFK-Frameworks mit deiner Konfiguration an. So sehen wir, ob dein Controller, Model oder deine Route wie beschrieben funktioniert oder fehlschlägt.
  4. Analyse und Lösungsfindung
    Wir untersuchen:

    • Ob Konfigurationsfehler vorliegen (z. B. falscher Datenbanktreiber, falscher Pfad in 
      config/app.php

      ).

    • Ob fehlende oder falsche Namespaces in Controller- und Model-Klassen verwendet werden.
    • Eventuelle Tippfehler oder Namenskonflikte in Routen-Definitionen ( 
      routes/web.php

      ).

    • Ob die Datenbankverbindung korrekt aufgebaut wird und die Tabelle `users` tatsächlich existiert.

    Wir schlagen dir dann Lösungsansätze vor, z. B.: Anpassung der Model-Methode, Korrektur der Route, Änderung der Konfigurationswerte.

  5. Kommunikation der Lösungen
    Sobald wir einen Lösungsweg gefunden haben, schicken wir dir eine detaillierte E-Mail mit:

    • Schritt-für-Schritt-Anleitung (z. B. „Öffne die Datei 
      app/Models/UserModel.php

      und ersetze die Methode `getAll()` durch diesen Code…“).

    • Hinweisen auf mögliche Nebeneffekte (z. B. Caching, Rechtevergabe im Dateisystem).
    • Optionalen Empfehlungen, wie du künftig ähnliche Probleme selbst erkennen kannst (z. B. Nutzung von 
      log_debug()

      zur Fehlersuche).

  6. Ticketabschluss und Nachverfolgung
    Hast du den Fix angewendet, gib uns bitte kurz Bescheid, ob das Problem behoben ist. Ist alles in Ordnung, schließen wir dein Ticket. Falls danach noch Fragen offen sind, bearbeiten wir dein Anliegen einmalig weiter, ohne dass dafür zusätzliche Kosten anfallen.

5. Reaktionszeiten und Service-Level

Unser Ziel ist, dir rasch weiterzuhelfen. Daher haben wir folgende Service-Level definiert:

  • Standardanfragen (werktags, 09:00 – 17:00 Uhr)
    Wir bemühen uns, innerhalb von 24 Stunden eine erste Rückmeldung zu geben.
  • Dringende Anfragen (z. B. Produktionsausfall)
    Wenn du in deiner E-Mail deutlich machst, dass dein Live-System nicht mehr funktioniert, versuchen wir, binnen 4 Stunden zu antworten.
  • Wochenend- und Feiertagsanfragen
    Anfragen, die außerhalb unserer Support-Zeiten eingehen, werden am nächsten Werktag bearbeitet.

Bitte achte darauf, dass deine Anfrage alle notwendigen Informationen enthält (siehe Abschnitt 3). Fehlen Details, verzögert sich die Bearbeitung, weil wir zunächst Nachfragen stellen müssen.

6. Kosten und Abrechnung

Der phpFK E-Mail-Support wird pauschal pro Ticket abgerechnet. Es gibt folgende Kategorien:

  • Basis-Ticket
    Gilt für einfachere Fragestellungen, die wir in bis zu 60 Minuten bearbeiten können. Du erhältst eine feste Pauschale.
  • Erweitertes Ticket
    Wenn wir voraussichtlich bis zu 120 Minuten benötigen (z. B. komplexe Model-/Controller-Fragen, umfangreiche Konfigurationsanpassungen), berechnen wir eine höhere Pauschale.
  • Komplexe Anfrage
    Für sehr umfangreiche oder nicht klar eingrenzbare Probleme erstellen wir nach Rücksprache ein individuelles Angebot.

Die genauen Beträge findest du auf der Produktseite unter „phpFK Email Support“. Nach Bearbeitung erhältst du eine Rechnung mit der detaillierten Aufschlüsselung. Als Bestandskunde wird die Pauschale über dein bestehendes Kundenkonto abgerechnet; ansonsten schicken wir dir die Rechnung separat per E-Mail.

7. Häufige Fragen (FAQ)

7.1. Kann ich den Fortschritt meiner Anfrage verfolgen?

Ja. Mit deiner Anfrage erhältst du automatisch eine Ticketnummer (z. B. #PK-2025-005). Jede Antwort von uns trägt dieses Kürzel im Betreff, sodass du immer weißt, dass es zu deinem Ticket gehört. Falls du nachhaken möchtest, antworte bitte direkt auf unsere E-Mail mit dieser Ticketnummer.

7.2. Was gehört nicht zum phpFK E-Mail-Support?

  • Anfragen zu anderen PHP-Frameworks oder generellen PHP-Themen (z. B. Laravel, Symfony, WordPress).
  • Webserver-spezifische Probleme (z. B. Apache-Module, Nginx-Load-Balancer), sofern sie nicht direkt mit phpFK zusammenhängen.
  • Fragen zu Hosting, Serveradministration, Netzwerk- oder Infrastrukturthemen ohne direkten phpFK-Bezug.
  • Frontend-Design, CSS- oder JavaScript-Probleme, die nichts mit der phpFK-Logik zu tun haben.

In solchen Fällen können wir dir höchstens allgemeine Hinweise geben, verweisen dich aber auf spezialisierte Foren oder Dienstleister.

7.3. Benötige ich eine lokale Testumgebung?

Falls möglich, ist es hilfreich, eine lokale Testumgebung (z. B. mithilfe von Docker, XAMPP oder MAMP) aufzusetzen. So kannst du dein Problem isolieren und wir sehen schneller, welche Fehlermeldungen auftreten. Sollte das nicht klappen, reicht es in der Regel, wenn du uns entsprechende Log-Dateien und Konfigurationsdateien zuschickst.

7.4. Wie schütze ich sensible Daten?

Beim Einsenden von Log-Auszügen oder Konfigurationsdateien achte bitte darauf, sensible Daten wie Passwörter, API-Keys oder private Schlüssel unkenntlich zu machen. Du kannst Platzhalter verwenden, z. B.

'password' => 'DEIN_PASSWORT_HIER'

. So bewahren wir beide die Sicherheit deiner Daten.

8. Tipps für eine erfolgreiche Unterstützung

Damit wir dir schnell und zielgerichtet helfen können, beachte bitte folgende Hinweise:

  • Füge nur relevante Abschnitte ein
    Poste kurze Ausschnitte aus Konfigurationsdateien oder Logs, die das eigentliche Problem betreffen. Lange Dateien oder ungekürzte Dumps erschweren die Analyse.
  • Zeige klare Fehlermeldungen
    Wenn du einen Exception-Stack-Trace siehst, kopiere direkt die Fehlermeldung samt Dateiname und Zeilennummer. Beispiel:

    Fatal error: Uncaught Error: Class 'App\Models\UserModel' not found in /pfad/zum/projekt/app/Controllers/UserController.php:34
  • Nutze Screenshots nur bei Bedarf
    Manchmal hilft ein kurzer Screenshot des Browser-Fehlers (weißes Blatt, typische phpFK-Fehlermeldung), aber achte auf Lesbarkeit und Beschneidung unnötiger Bereiche.
  • Verwende das richtige End-of-Line-Format
    Sollte deine Konfiguration fehlerhaft sein, kann es am Zeilenende oder Zeichensatz liegen. Achte darauf, dass Dateien im UNIX-Format (LF) gespeichert sind, nicht mit Windows-CRLF.
  • Dokumentiere Änderungen chronologisch
    Wenn du Dinge ausprobierst, notiere kurz das Datum und die Maßnahme, z. B.:

    2025-06-02: Route '/users' angepasst, neues Query-Log aktiviert.

    So sieht man direkt, was du bereits verändert hast.

9. Beispiel einer Muster-Anfrage

Nachfolgend findest du ein Beispiel, das du als Vorlage für deine eigene Anfrage verwenden kannst:

Betreff: phpFK: Model-Methode getAll() liefert leeres Ergebnis

Hallo Team,

ich arbeite mit phpFK Version 2.3.1 auf PHP 8.1.0 und möchte im Controller `UserController` eine Liste aller Benutzer aus der Tabelle `users` anzeigen.

Rahmendaten:
- phpFK-Version: 2.3.1
- PHP-Version: 8.1.0
- Datenbank: MySQL 5.7
- Webserver: Apache 2.4, PHP-FPM
- Betriebssystem: Ubuntu 20.04

Schritte zur Reproduktion:
1. Controller `app/Controllers/UserController.php` angelegt:
   namespace App\Controllers;

   use Core\Controller;

   class UserController extends Controller
   {
       public function index()
       {
           $users = $this->model('UserModel')->getAll();
           $this->view('users/index', ['users' => $users]);
       }
   }

2. Model `app/Models/UserModel.php` angelegt:

   namespace App\Models;

   use Core\Model;

   class UserModel extends Model
   {
       public function getAll()
       {
           return $this->db->table('users')->get()->result();
       }
   }

3. Route definiert in `routes/web.php`:

   $router->get('/users', 'UserController@index');

4. Im Browser aufgerufen: http://deine-domain.de/users
5. Ergebnis: Weiße Seite, keine Fehlermeldung, Array ist leer.

Fehlerausgaben und Logs:
– In `storage/logs/error.log` steht:

  [2025-06-02 14:23:11] ERROR: QueryException: Table 'datenbank.users' doesn't exist in /pfad/zum/projekt/vendor/phpfk/database/QueryBuilder.php:87

Konfiguration:
– Auszug aus `config/db.php`:

  return [
      'driver' => 'mysql',
      'host' => '127.0.0.1',
      'database' => 'datenbank',
      'username' => 'mein_user',
      'password' => 'DEIN_PASSWORT_HIER',
      'charset' => 'utf8mb4',
      'collation' => 'utf8mb4_unicode_ci'
  ];

Bereits unternommene Lösungsversuche:
– Tabelle `users` existiert tatsächlich in der Datenbank.
– Ich habe versucht, `php fk cache:clear` auszuführen.
– Debug-Modus ist aktiviert:

'debug' => true

in `config/app.php`.

Erwartetes Verhalten:
– `getAll()` soll alle Benutzer-Datensätze als Array zurückliefern und diese in `views/users/index.php` korrekt darstellen.

Danke für eure Hilfe!

Du kannst dieses Beispiel als Grundlage verwenden und die Bereiche anpassen, die für dein spezielles Problem relevant sind.

10. Organisatorische Hinweise

Damit der Support reibungslos funktioniert, beachte bitte:

  • Support-Adresse
    Schreibe deine Anfrage an

    support@frank-karau.de

    und lasse den Betreff am besten so stehen, wie oben beschrieben.

  • Dateianhänge
    Komprimiere Log-Dateien oder mehrere Konfigurationsdateien in ein ZIP-Archiv und schicke sie als Anhang. Achte darauf, sensible Daten vorher unkenntlich zu machen.
  • Zeitzone
    Unser Support-Team arbeitet werktags von 09:00 bis 17:00 Uhr (Mitteleuropäische Zeit). Nach 17:00 eingehende Nachrichten werden am nächsten Werktag bearbeitet.

11. Zusammenfassung und Ausblick

Mit dem phpFK Email-Support erhältst du zielgerichtete Hilfe zu allen Fragen rund um das phpFK-Framework. Damit wir dir schnell helfen können, strukturiere deine Anfrage nach den oben genannten Punkten. Halte Versionsangaben, Log-Ausschnitte und Konfigurationsdateien bereit, um Rückfragen zu vermeiden. Unsere Service-Level sehen eine erste Antwort innerhalb von 24 Stunden für Standardanfragen und innerhalb von 4 Stunden für dringende Fälle vor. Die Abrechnung erfolgt pauschal pro Ticket; die genauen Preise findest du auf der Produktseite phpFK Email Support.

Wir freuen uns darauf, dich bei deinem phpFK-Projekt zu unterstützen und wünschen dir viel Erfolg bei der Umsetzung deiner Webanwendung!