Dependency Injection in PHP (IoC Pattern)
Kurze Recherche zu Dependency Injection in PHP (Inversion of Control Pattern)
Erläuterungen zu DI und IoC http://martinfowler.com/articles/injection.html
Seit einiger Zeit ist das Thema DI in PHP recht aktuell mittlerweile gibt es einige selbständige Dependency Injection Container und einige DI Container welche aus einem Framework entstanden sind oder zu diesem gehören.
Folgende DI Lösungen in PHP habe ich auf die schnelle gefunden und kurz angesehen:
- Symfony Dependency Injection ( http://components.symfony-project.org/dependency-injection/ )
Die DI Lösung des Symfony Frameworks, sehr ausführliche Dokumentation, kann sehr einfach mit anderen Frameworks verwendet werden (für Zend Framework keine anpassungen nötig). Konfiguration über pures PHP, YAML oder XML möglich. - Yadif ( http://code.google.com/p/yadif/ )
Konfiguration der Container über PHP, ausser dem Usage Example keine weitere Dokumentation gefunden. - Pico Container
DI Container welcher in mehreren Programmiersprachen umgesetzt wurde (u.a. Java, Dotnet, PHP)
SVN momentan nicht erreichbar.
Dokumentation ist sehr umfangreich inklusive Erklärungen zu den verschiedenen DI Arten
Wirklich getestet habe ich nur den Symfony DI Container, um das mal ein bisschen zu verdeutlichen hier eine Beispiel Konfiguration und ein bisschen Beispiel Code:
Als Konfigurationsformat habe ich XML ausgewählt die Konfiguration meines DI Containers für ein Beispiel Projekt sieht bei mir so aus
-
<?xml version="1.0" encoding="UTF-8"?>
-
-
<container xmlns="http://symfony-project.org/2.0/container">
-
<services>
-
-
<!-- PageCache -->
-
<service id="pagecache" class="Zend_Cache" shared="true" constructor="factory">
-
<file>Zend/Cache.php</file>
-
<argument>Page</argument>
-
<argument>File</argument>
-
<argument type="collection">
-
<argument key="lifetime">3600</argument>
-
<argument key="default_options" type="collection">
-
<argument key="make_id_with_get_variables">true</argument>
-
<argument key="make_id_with_cookie_variables">false</argument>
-
<argument key="specific_lifetime">3600</argument>
-
<argument key="cache_with_session_variables">true</argument>
-
<argument key="cache_with_post_variables">true</argument>
-
<argument key="cache_with_get_variables">true</argument>
-
<argument key="tags" type="collection">
-
<argument>page</argument>
-
</argument>
-
</argument>
-
<argument key="lifedebug_header">false</argument>
-
</argument>
-
<argument type="collection">
-
<argument key="cache_dir">../tmp/</argument>
-
</argument>
-
<call method="start">
-
</call>
-
</service>
-
<!-- ENDE PageCache -->
-
-
-
<!-- Loggging -->
-
<service id="log" class="Logger" shared="true">
-
<argument type="service">
-
<service class="Zend_Log" shared="true">
-
<argument type="service">
-
<service class="Zend_Log_Writer_Stream" shared="true">
-
<argument>../log/debug.log</argument>
-
<call method="setFormatter">
-
<argument type="service">
-
<service class="Zend_Log_Formatter_Simple" shared="true">
-
<argument>%%timestamp%%|%%sessionId%%|%%priorityName%%|%%fkn%%.%%line%%|%%message%%
-
</argument>
-
</service>
-
</argument>
-
</call>
-
</service>
-
</argument>
-
</service>
-
</argument>
-
<call method="setLevel">
-
<argument>7</argument>
-
</call>
-
</service>
-
<!-- ENDE Loggging -->
-
-
<!-- Cache -->
-
<service id="cache" class="Zend_Cache" shared="true" constructor="factory">
-
<file>Zend/Cache.php</file>
-
<argument>Core</argument>
-
<argument>File</argument>
-
<argument type="collection">
-
<argument key="automatic_serialization">true</argument>
-
</argument>
-
<argument type="collection">
-
<argument key="cache_dir">../tmp/</argument>
-
</argument>
-
</service>
-
-
<!-- END Cache -->
-
-
</services>
-
</container>
Die Konfiguration bewirkt das ich in der Anwendung nachher einen PageCache, einen Logger und einen normalen Cache einsatzbereit zur Verfügung habe sobald ich diese benötig.
Ein Hinweis noch zu den möglichen Attributen der Service Node besonders praktisch sind hier die Attribute "shared" und "constructor" mit dem shared Attribut kann angegeben werden ob nur eine Instanz dieses Service erstellt wird und bei jedem Zugriff darauf die selbe Instanz zurück gegeben wird, oder ob immer eine neue Instanz zurück gegeben wird. Über die "constructor" Attribut kann angebeben werden ob es sich um einen statischen oder nicht statischen Aufruf handelt. Für Zend_Cache wird der Aufruf Zend_Cache::factory(Core, File,...) verwendet. An der Klasse Logger wird der Konstruktor mit den angegebenen Parametern aufgerufen.
Im PageCache Beispiel wird direkt nach der Erstellung des Objekts noch die Methode start() aufgerufen.
Innerhalb der Anwendung wird der Container folgendermaßen initialisiert und Verwendet:
-
require_once $basePath.'/lib/sf/sfServiceContainerAutoloader.php';
-
-
// Symfony Autoloader registrieren
-
sfServiceContainerAutoloader::register();
-
-
// haben wir schon einen Fertigen DI Container?
-
{
-
require_once $configPath.'/di.container.conf.xml.php';
-
$sc = new SampleServiceContainer();
-
}
-
else
-
{
-
// noch kein DI Container vorhanden, also aus XML erstellen
-
$sc = new sfServiceContainerBuilder();
-
$loader = new sfServiceContainerLoaderFileXml($sc);
-
$loader->load($configPath.'/di.container.conf.xml');
-
$dumper = new sfServiceContainerDumperPhp($sc);
-
}
-
-
// Folgende Aufrufe können dann innerhalb der Anwendung verwendet werden
-
// Zugriff auf den Cache
-
$cache = $sc->cache;
-
-
// Zugriff auf den Logger
-
$log = $sc->log
noch Fragen? Doku anschauen ;-)