サービスコンテナ

1

<argument type="string">http://symfony.com/?foo=%%s&bar=%%d</argument>

パラメータの目的は、サービスに情報を渡すことです。もちろんパラメータが無くても問題ありません。ただし、パラメータを使用すると、次のような利点があります。

• すべてのサービス「オプション」を統一された「パラメータ」キーの下に分離して整理する

• パラメータ値複数のサービス定義で使用可能

• バンドルでサービスを作成する場合、パラメーターを使用すると、グローバル プログラムでサービスを簡単にカスタマイズできます

パラメータを使用するかどうかはあなたが選択します。高品質のサードパーティ バンドルは、コンテナに保存されているサービスをより「構成可能」にするため、常にパラメータを使用します。もちろん、パラメーターによってもたらされる柔軟性は必要ない場合もあります。

配列パラメータ ¶

パラメータには配列を含めることができます。「配列パラメータ (配列パラメータ)」を参照してください。

参照 (インジェクション) サービス ¶

この時点で、元の app.mailer サービスは単純です。パラメータは 1 つだけです。コンストラクターがあるため、設定が簡単です。 1 つ以上のコンテナー内の他のサービスに依存するサービスを作成すると、コンテナーの真の力が発揮され始めることが期待できます。

たとえば、電子メール メッセージを管理し、一連のアドレスに送信するのに役立つ新しいサービス NewsletterManager があるとします。 app.mailer このサービスはすでに電子メールを送信できるため、NewsletterManager でこのサービスを使用してメッセージ配信部分を処理できます。このクラスは次のようになります:

// src/Acme/HelloBundle/Newsletter/NewsletterManager.phpnamespace Acme\HelloBundle\Newsletter; use Acme\HelloBundle\Mailer; class NewsletterManager{
    protected $mailer;     public function __construct(Mailer $mailer)
    {
        $this->mailer = $mailer;
    }     // ...}

サービス コンテナを使用しない場合は、コントローラーで簡単に NewsletterManager を作成できます:

use Acme\HelloBundle\Newsletter\NewsletterManager; // ... public function sendNewsletterAction(){
    $mailer = $this->get('app.mailer');
    $newsletter = new NewsletterManager($mailer);
    // ...}

これを実装することができます。しかし、将来 NewsletterManager クラスに 2 番目または 3 番目のコンストラクター パラメーターを追加したい場合はどうすればよいでしょうか?コードをリファクタリングして、このクラスの名前を変更する場合はどうなるでしょうか?どちらの場合も、NewsletterManager クラスがインスタンス化されている各場所を見つけて、手動でカスタマイズする必要があります。サービス コンテナーがより魅力的な処理方法を提供していることは疑いの余地がありません:

PHP:// app/config/services.phpuse Symfony\Component\DependencyInjection\Definition;use Symfony\Component\DependencyInjection\Reference; $container->setDefinition('app.mailer', ...); $container->setDefinition('app.newsletter_manager', new Definition(
    'AppBundle\Newsletter\NewsletterManager',
    array(new Reference('app.mailer'))));

XML:<!-- app/config/services.xml --><?xml version="1.0" encoding="UTF-8" ?><container xmlns="http://symfony.com/schema/dic/services"    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"    xsi:schemaLocation="http://symfony.com/schema/dic/services        http://symfony.com/schema/dic/services/services-1.0.xsd">     <services>
        <service id="app.mailer">
        <!-- ... -->
        </service>         <service id="app.newsletter_manager" class="AppBundle\Newsletter\NewsletterManager">
            <argument type="service" id="app.mailer"/>
        </service>
    </services></container>

YAML:# app/config/services.ymlservices:
    app.mailer:        # ...
    app.newsletter_manager:
        class:     AppBundle\Newsletter\NewsletterManager
        arguments: ['@app.mailer']

YAML では、特殊な @app.mailer 構文により、コンテナに app.mailer という名前のサービスを見つけて、このオブジェクトを NewsletterManager に渡すよう指示します。 ■ コンストラクターのパラメーター。この例では、指定された app.mailer サービスは存在します。存在しない場合は、例外がスローされます。ただし、依存関係をオプションとしてマークすることはできます。このトピックについては次のセクションで説明します。

(サービスへの) 参照は、依存関係が明確に定義された独立したサービスを作成できる強力なツールです。この例では、app.newsletter_manager サービスは、その機能を実装するために app.mailer サービスに依存する必要があります。この依存関係をサービス コンテナーで定義すると、コンテナーはこのクラスをインスタンス化するすべての作業をホストします。

オプションの依存関係: Setter 注入 ¶

依存オブジェクトをコンストラクターに注入することは、依存関係を確実に利用できるようにする 1 つの方法です (そうしないとコンストラクターは実行できません)。ただし、クラスの場合、オプションの依存関係がある場合は、「セッター注入」の方が良い解決策です。これは、コンストラクターではなくクラス メソッドを使用して依存関係を注入することを意味します。クラスは次のようになります:

namespace AppBundle\Newsletter; use AppBundle\Mailer; class NewsletterManager{
    protected $mailer;     public function setMailer(Mailer $mailer)
    {
        $this->mailer = $mailer;
    }     // ...}

サービス定義はセッター インジェクションに応じて調整する必要があります:

PHP:// app/config/services.phpuse Symfony\Component\DependencyInjection\Definition;use Symfony\Component\DependencyInjection\Reference; $container->setDefinition('app.mailer', ...); $container->setDefinition('app.newsletter_manager', new Definition(
    'AppBundle\Newsletter\NewsletterManager'))->addMethodCall('setMailer', array(
    new Reference('app.mailer'),));

XML:<!-- app/config/services.xml --><?xml version="1.0" encoding="UTF-8" ?><container xmlns="http://symfony.com/schema/dic/services"    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"    xsi:schemaLocation="http://symfony.com/schema/dic/services        http://symfony.com/schema/dic/services/services-1.0.xsd">     <services>
        <service id="app.mailer">
        <!-- ... -->
        </service>         <service id="app.newsletter_manager" class="AppBundle\Newsletter\NewsletterManager">
            <call method="setMailer">
                <argument type="service" id="app.mailer" />
            </call>
        </service>
    </services></container>

YAML:# app/config/services.ymlservices:
    app.mailer:        # ...
    app.newsletter_manager:
        class:     AppBundle\Newsletter\NewsletterManager
        calls:            - [setMailer, ['@app.mailer']]

PHP中国語ウェブサイト

ホームページコース記事に質問辞書マニュアルダウンロード検索 APPダウンロード