Movatterモバイル変換

[0]ホーム
URL:

Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

 Sign up
Appearance settings

Creating parameters page in DI component#2322

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to ourterms of service andprivacy statement. We’ll occasionally send you account related emails.

Already on GitHub?Sign in to your account

Merged
Merged
Show file tree
Hide file tree
Changes from1 commit
Commits
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
NextNext commit
Creating parameters page in DI component
  • Loading branch information
@richardmiller-zz
richardmiller-zz committedMar 20, 2013
commitba095e8e7e693eb2d0d48676384c70ee4d1c7ace
68 changes: 1 addition & 67 deletionsbook/service_container.rst
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -222,15 +222,6 @@ The end result is exactly the same as before - the difference is only in
to look for parameters with those names. When the container is built, it
looks up the value of each parameter and uses it in the service definition.

.. note::

The percent sign inside a parameter or argument, as part of the string, must
be escaped with another percent sign:

.. code-block:: xml

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

The purpose of parameters is to feed information into services. Of course
there was nothing wrong with defining the service without using any parameters.
Parameters, however, have several advantages:
Expand All@@ -248,64 +239,6 @@ third-party bundles will *always* use parameters as they make the service
stored in the container more configurable. For the services in your application,
however, you may not need the flexibility of parameters.

Array Parameters
~~~~~~~~~~~~~~~~

Parameters do not need to be flat strings, they can also be arrays. For the XML
format, you need to use the type="collection" attribute for all parameters that are
arrays.

.. configuration-block::

.. code-block:: yaml

# app/config/config.yml
parameters:
my_mailer.gateways:
- mail1
- mail2
- mail3
my_multilang.language_fallback:
en:
- en
- fr
fr:
- fr
- en

.. code-block:: xml

<!-- app/config/config.xml -->
<parameters>
<parameter key="my_mailer.gateways" type="collection">
<parameter>mail1</parameter>
<parameter>mail2</parameter>
<parameter>mail3</parameter>
</parameter>
<parameter key="my_multilang.language_fallback" type="collection">
<parameter key="en" type="collection">
<parameter>en</parameter>
<parameter>fr</parameter>
</parameter>
<parameter key="fr" type="collection">
<parameter>fr</parameter>
<parameter>en</parameter>
</parameter>
</parameter>
</parameters>

.. code-block:: php

// app/config/config.php
use Symfony\Component\DependencyInjection\Definition;

$container->setParameter('my_mailer.gateways', array('mail1', 'mail2', 'mail3'));
$container->setParameter('my_multilang.language_fallback', array(
'en' => array('en', 'fr'),
'fr' => array('fr', 'en'),
));


Importing other Container Configuration Resources
-------------------------------------------------

Expand DownExpand Up@@ -967,6 +900,7 @@ its id:
Learn more
----------

* :doc:`/components/dependency_injection/parameters`
* :doc:`/components/dependency_injection/compilation`
* :doc:`/components/dependency_injection/definitions`
* :doc:`/components/dependency_injection/factories`
Expand Down
24 changes: 3 additions & 21 deletionscomponents/dependency_injection/definitions.rst
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -2,31 +2,13 @@
single: Dependency Injection; Service definitions


Working with Container Parameters and Definitions
=================================================

Getting and Setting Container Parameters
----------------------------------------

Working with container parameters is straight forward using the container's
accessor methods for parameters. You can check if a parameter has been defined
in the container with::

$container->hasParameter($name);

You can retrieve parameters set in the container with::

$container->getParameter($name);

and set a parameter in the container with::

$container->setParameter($name, $value);
Working with Container Service Definitions
==========================================

Getting and Setting Service Definitions
---------------------------------------

There are also some helpful methods for
working with the service definitions.
There are some helpful methods for working with the service definitions.

To find out if there is a definition for a service id::

Expand Down
1 change: 1 addition & 0 deletionscomponents/dependency_injection/index.rst
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -6,6 +6,7 @@

introduction
types
parameters
definitions
compilation
tags
Expand Down
252 changes: 252 additions & 0 deletionscomponents/dependency_injection/parameters.rst
View file
Open in desktop
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,252 @@
.. index::
single: Dependency Injection; Parameters

Introduction to Parameters
=================================

You can define parameters in the service container which can then be used
directly or as part of service definitions. This can help to separate out
values that you will want to change more regularly.

Getting and Setting Container Parameters
----------------------------------------

Working with container parameters is straight forward using the container's
accessor methods for parameters. You can check if a parameter has been defined
in the container with::

$container->hasParameter('mailer.transport');

You can retrieve parameters set in the container with::

$container->getParameter('mailer.transport');

and set a parameter in the container with::

$container->setParameter('mailer.transport', 'sendmail');

.. note::

You can only set a parameter before the container is compiled. To learn
more about compiling the container see
:doc:`/components/dependency_injection/compilation`

Parameters in Configuration Files
---------------------------------

You can also use the ``parameters`` section of a config file to set parameters:

.. configuration-block::

.. code-block:: yaml

parameters:
mailer.transport: sendmail

.. code-block:: xml

<parameters>
<parameter key="mailer.transport">sendmail</parameter>
</parameters>

.. code-block:: php

$container->setParameter('mailer.transport', 'sendmail');

As well as retrieving the parameter values directly from the container you
can use them in the config files. You can refer to parameters elsewhere in
the config files by surrounding them with percent (``%``) signs, e.g.
``%mailer.transport%``. One use is for this is to inject the values into your
services. This allows you to configure different versions of services between
applications or multiple services based on the same class but configured
differently within a single application. You could inject the choice of mail
transport into the ``Mailer`` class directly but by making it a parameter it
makes it easier to change rather than being tied up with the service definition:

.. configuration-block::

.. code-block:: yaml

parameters:
mailer.transport: sendmail

services:
mailer:
class: Mailer
arguments: [%mailer.transport%]
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

strings using% or@ sign in Yaml should be between quotes ('%mailer.transport%'), as those are reserved characters in Yaml. Please fix this in other places in this document too


.. code-block:: xml

<parameters>
<parameter key="mailer.transport">sendmail</parameter>
</parameters>

<services>
<service id="mailer" class="Mailer">
<argument>%mailer.transport%</argument>
</service>

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

unneeded empty line here

</services>

.. code-block:: php

use Symfony\Component\DependencyInjection\Reference;

// ...
$container->setParameter('mailer.transport', 'sendmail');
$container
->register('mailer', 'Mailer')
->addArgument('%mailer.transport%');

If we were using this elsewhere as well, then it would only need changing
in one place if a different transport was required.

You can also use the parameters in the service definition, for example,
making the class of a service a parameter:

.. configuration-block::

.. code-block:: yaml

parameters:
mailer.transport: sendmail
mailer.class: Mailer

services:
mailer:
class: %mailer.class%
arguments: [%mailer.transport%]

.. code-block:: xml

<parameters>
<parameter key="mailer.transport">sendmail</parameter>
<parameter key="mailer.class">Mailer</parameter>
</parameters>

<services>
<service id="mailer" class="%mailer.class%">
<argument>%mailer.transport%</argument>
</service>

</services>

.. code-block:: php

use Symfony\Component\DependencyInjection\Reference;

// ...
$container->setParameter('mailer.transport', 'sendmail');
$container->setParameter('mailer.class', 'Mailer');
$container
->register('mailer', '%mailer.class%')
->addArgument('%mailer.transport%');

$container
->register('newsletter_manager', 'NewsletterManager')
->addMethodCall('setMailer', array(new Reference('mailer')));

.. note::

The percent sign inside a parameter or argument, as part of the string, must
be escaped with another percent sign:

.. code-block:: xml

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

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

If there is no reason to only show the XML format, I prefer to have them all.


Array Parameters
----------------

Parameters do not need to be flat strings, they can also be arrays. For the XML
format, you need to use the type="collection" attribute for all parameters that are
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

you should puttype="collection" in an inline codeblock.

arrays.

.. configuration-block::

.. code-block:: yaml

# app/config/config.yml
parameters:
my_mailer.gateways:
- mail1
- mail2
- mail3
my_multilang.language_fallback:
en:
- en
- fr
fr:
- fr
- en

.. code-block:: xml

<!-- app/config/config.xml -->
<parameters>
<parameter key="my_mailer.gateways" type="collection">
<parameter>mail1</parameter>
<parameter>mail2</parameter>
<parameter>mail3</parameter>
</parameter>
<parameter key="my_multilang.language_fallback" type="collection">
<parameter key="en" type="collection">
<parameter>en</parameter>
<parameter>fr</parameter>
</parameter>
<parameter key="fr" type="collection">
<parameter>fr</parameter>
<parameter>en</parameter>
</parameter>
</parameter>
</parameters>

.. code-block:: php

// app/config/config.php
use Symfony\Component\DependencyInjection\Definition;

$container->setParameter('my_mailer.gateways', array('mail1', 'mail2', 'mail3'));
$container->setParameter('my_multilang.language_fallback', array(
'en' => array('en', 'fr'),
'fr' => array('fr', 'en'),
));

Constants as Parameters
-----------------------

The container also has support for setting PHP constants as parameters. To
take advantage of this feature, map the name of your constant to a parameter
key, and define the type as ``constant``.

.. code-block:: 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">

<parameters>
<parameter key="global.constant.value" type="constant">GLOBAL_CONSTANT</parameter>
<parameter key="my_class.constant.value" type="constant">My_Class::CONSTANT_NAME</parameter>
</parameters>
</container>

.. note::

This only works for XML configuration. If you're *not* using XML, simply
import an XML file to take advantage of this functionality:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

Well, actually, it is also supported in PHP config files: simply use the constant


.. configuration-block::

.. code-block:: yaml

# app/config/config.yml
imports:
- { resource: parameters.xml }

.. code-block:: php

// app/config/config.php
$loader->import('parameters.xml');

Loading
[8]ページ先頭
©2009-2025 Movatter.jp