Verständnis des Symfony Bundle -Konfiguration und des Service Containers

In diesem Artikel wird die Symfony2 -Bundle -Konfiguration und seine Interaktion mit dem Abhängigkeitsinjektionsbehälter untersucht. Diese Konzepte können für Neuankömmlinge, insbesondere für diejenigen, die mit Abhängigkeitsinjektion nicht vertraut sind, eine Herausforderung sein. Die Beispiele hier verwenden YAML, obwohl Symfony XML- und PHP -Arrays unterstützt. Die Wahl hängt von der Präferenz ab; Es gibt keine einzige "beste" Option.

Schlüsselkonzepte:

• Symfony -Bündel: Ähnlich wie bei Plugins, Bündel Kapitalfunktionen (Blogs, Foren usw.). Sie fördern Modularität und Code -Wiederverwendung. Sie können vorgefertigt oder maßgeschneidert sein.
• Bundle -Konfiguration: kann direkt in der Hauptanwendungskonfigurationsdatei (einfacher, aber weniger tragbar) oder in dedizierten Bündelkonfigurationsdateien (modularer und wiederverwendbarer) konfiguriert werden. Die semantische Konfiguration unter Verwendung einer Erweiterungsklasse bietet die größte Flexibilität für komplexe, verteilbare Bündel.
• Abhängigkeitsinjektionskontainer: verwaltet Service -Lebenszyklen und Abhängigkeiten, was zu saubereren, wartbaren und testbaren Code führt.
• Debugging: Verwenden Sie Konsolenbefehle wie debug:container und debug:config, um Service -Registrierungen und -konfigurationen zu beheben.

Bündelerstellung:

Ein Bundle ist ein Verzeichnis, das Dateien enthält (PHP, CSS, JavaScript, Bilder), die eine einzelne Funktion implementieren. In Symfony2 ist fast alles ein Bündel. Beim Erstellen eines Bundle (manuell oder verwendet php app/console generate:bundle) ist die BundleNameBundle.php -Datei von entscheidender Bedeutung. Seine Klasse erweitert SymfonyComponentHttpKernelBundleBundle und registriert das Bündel in AppKernel::registerBundles(). Der optionale BundleNameExtension.php (im Ordner DependencyInjection) lädt und verwaltet die Konfiguration des Bundle.

Ladebündelkonfiguration (einfacher Weg):

Der einfachste Ansatz konfiguriert Parameter und Dienste direkt innerhalb app/config/config.yml. Während der Funktionsumgebung passt dies das Bündel fest in die Anwendung und begrenzt die Portabilität. Eine bessere (wenn noch weniger ideale) Alternative besteht darin, eine separate Konfigurationsdatei (z. B. Resources/config/services.yml) im Bundle zu erstellen und in die Hauptkonfigurationsdatei zu importieren:

imports:
    - { resource: parameters.yml }
    - { resource: security.yml }
    - { resource: ../../src/Cvuorinen/ExampleBundle/Resources/config/services.yml }

Ladebündelkonfiguration (semantische Weise):

Die BundleNameExtension.php -Klassel lädt die Konfigurationslade. Es verwendet eine Configuration.php -Klasse (auch in DependencyInjection) zur Validierung und Verarbeitung von Bundle-bezogenen Konfigurationen aus app/config/. Die Erweiterung lädt dann die bündelspezifische Konfiguration (aus Resources/config/) unter Verwendung eines Laders (z. B. YamlFileLoader). Hier definierte Dienste können Parameter aus der Hauptanwendungskonfiguration verwenden. Dieser Ansatz ist besonders nützlich, um wiederverwendbare, verteilbare Bündel zu erstellen.

Konfigurationsdateistruktur:

Konfigurationsdateien enthalten hauptsächlich Parameter und Dienste.

• Parameter: statische Werte (Anmeldeinformationen, API -Schlüssel, URLs). Definiert unter der Taste parameters. Best Practice ist es, Serviceklassennamen als Parameter für eine bessere Erweiterbarkeit zu definieren.

• Dienste: Klassen mit Geschäftslogik. Das Definieren in der Konfigurationsdatei nutzt Abhängigkeitsinjektion.

Beispiel services.yml:

imports:
    - { resource: parameters.yml }
    - { resource: security.yml }
    - { resource: ../../src/Cvuorinen/ExampleBundle/Resources/config/services.yml }

Verwenden Sie app/console container:debug, um die Konfiguration zu testen und zu debuggen.

Verwenden von Diensten in einem Controller:

Ein einfacher Greeter Service:

parameters:
    cvuorinen_example.greeter.class: Cvuorinen\ExampleBundle\Service\Greeter
    cvuorinen_example.greeter.greeting: "Hello"

services:
    cvuorinen_example.greeter:
        class: %cvuorinen_example.greeter.class%
        arguments: [%cvuorinen_example.greeter.greeting%]

ein Controller, der den Dienst verwendet:

namespace Cvuorinen\ExampleBundle\Service;

class Greeter
{
    public function greet($name) { return "Hello $name"; }
}

Abhängigkeitsinjektion:

Das obige Beispiel zeigt die grundlegende Konstruktorinjektion. Symfony unterstützt auch die Setter- und Immobilieninjektion. Dienstleistungen können privat erklärt werden, um ihre Zugänglichkeit zu begrenzen. Fabriken können verwendet werden, um Dienste zu erstellen (z. B. mit dem Doctrine Entity Manager, um Repositorys zu erstellen).

Schlussfolgerung:

Dies bietet einen umfassenden Überblick über die Konfiguration und Abhängigkeitsinjektion von Symfony Bundle. Weitere Untersuchungen erweiterter Themen (übergeordnete Konfigurationen, Parameterfreigabe, Definieren von Controllern als Dienste) wird gefördert. Denken Sie daran, die offizielle Symfony -Dokumentation für detaillierte Informationen zu konsultieren. Vermeiden Sie es, den Servicecontainer selbst in Dienste zu injizieren, um eine lockere Kopplung aufrechtzuerhalten. Der FAQS -Abschnitt wird angesichts der detaillierten Erläuterung weggelassen.

Das obige ist der detaillierte Inhalt vonVerständnis des Symfony Bundle -Konfiguration und des Service Containers. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!