Freitag, 29. Januar 2016

ZF2 Modul.php Die Steuerzentrale eines Modules

Der Modulmanager sucht zuerst die Datei Modul.php diese muß den folgenden Kriterien entsprechen:

  1. Muß sie einen Namespace enthalten der den selben Namen trägt wie das Modul. Bsp.: Das Modul "Album" muß den Namespace "Album" verwenden.
  2. Muß sie eine Klasse mit dem Namen "Module" enthalten.
  3. Muß sie Konfiguratioenen enthalten für mindestens folgende drei Systeme:
    • view_manager
    • controllers
    • router

Ist der Namespace nicht definiert kommt es zu einem Fehler wie:

Fatal error: Uncaught exception 'Zend\ModuleManager\Exception\RuntimeException' with message 'Module (Album) could not be initialized.'

Der View_Manager ist für die Ausgabe der Anwendung zuständig.
Der Abschnitt "Controllers" ist für die Logische Abwiklung zuständig und wird oft von Diensten unterstützt (Schlüsselwort: "service_manager" )

Donnerstag, 28. Januar 2016

ZF2 application.config.php Einwohnermeldeamt der Anwendung

Die application.config.php der Skeleton Anwendung sieht ungefähr so aus:

return array(
    'modules' => array(
        'Application',
        'Album',
    ),
    'module_listener_options' => array(
        'config_glob_paths'    => array(
            'config/autoload/{,*.}{global,local}.php',
        ),
        'module_paths' => array(
            './module',
            './vendor',
        ),
    ),
);
 in dem Array "modules", müssen alle Module angemeldet werden, die in der Anwendung verwendet werden.

Der Modulmanager übernimmt den Rest und sucht dieses Modul in den Verzeichnisssen die in dem Array "modul_listener_options" unter dem zweiten Array 'module_paths' hinterlegt wurden. In diesem Fall sind das die Verzeichnisse  "/module" und "/vendor" die sich im Wurzelverzeichnis der Anwendung befinden müssen.

Dort wird nach einem Verzeichniss mit dem Namen des Modules gesucht in dem Fall des Tutorials nachdem Namen 'Album'. Dort wird nach einer Datei mit dem Namen "Module.php" gesucht.

../ (Wurzelverzeichnis der Anwendung)
/config/application.config.php
/data
/module
   /Album
       Module.php
/public
/vendor

Diese Datei muß den Namespace "Album" (sprich den Modulnamen) verwenden und eine Klasse Namens "Module". (Oder kurz ausgedrückt es wird in der Datei Module.php Nach der Qualifzierten Namen der Klasse "Album/Module" gesucht.)

Mittwoch, 27. Januar 2016

ZF2 Modul Verzeichnisse

Aufbau der Verzeichnisstruktur eines Modules 
     /module
         /Album
             /config
             /src
                 /Album
                     /Controller
                     /Form
                     /Model
             /view
                 /album
                     /album

Die Verzeichnisstruktur wurde dem aktuellen Tutorial 2.4 aus der ZF2 Dokumentation entnommen.

"/module" ist das Verzeichnis in dem sich alle Module befinden, die nicht zu dem Zend-Framework gehören, aber in der Anwendung bzw Applikation Verwendung finden sollen.

"/Album" ist das Modul das wir gerade bearbeiten / schreiben. Wobei natürlich Album immer in den aktuellen Modulnamen geändert werden muß.

"/config" ist unser Verzeichnis wo wir alle Einstellungen speichern - für den Fall das es Einstellungen gibt, die nur Lokal gelten, kann man noch ein Verzeichnis mit "/local" anlegen oder die entsprechende Datei mit "local.php" benennen. Dadurch wird es leichter beim verteilen, diese Datei weg zu lassen oder zu ändern.

"/src" ist das eigentliche Programm-Verzeichnis hier finden sich alle funktionen und strukturen, die nichts direkt mit der Ausgabe zu tun haben. Aber durchaus Werte für die Ausgabe bereitstellen können.

"/Album" ist das Verzeichnis zu dem Namespace Album. Sollten weiter Namensbereiche definiert werden, müssen auch mehrere Verzeichnisse entsprechend angelegt werden.
 
"/Controller" hier findet die eigentliche Steuerung des Modules bzw. der Funktion statt.
 
"/Form" hier ist die Steuerung von Eingabeformularen zu Hause. 
 
"/Model" hier werden die Datenstrukturen überprüft und funktionen zu Datenbankstrukturen hinterlegt, wobei Funktionen für einnen austausch von Daten auch in einem eigenen "/Mapper" Verzeichnis angelegt werden können.

"/Service" hier nicht mit aufgeführt, enthält Dienste/Funktionen zum ändern von Daten.

"/view" hier findet die eigentliche Ausgabe statt.

"/album" Name des Modules. 
 
"/album" Name des Namespace.Darunter finden sich dann die einzelnen Dateien für die Ausgabe.