-

Author: javiereguiluz

service_container.rst

@@ -334,19 +334,26 @@ as arguments of other services:
         services:
             App\Service\SomeService:
                 arguments:
-                    # arguments without a type are treated as strings
+                    # string, numeric and boolean arguments can be passed "as is"
                     - 'Foo'
-                    # explicitly declare a string argument
-                    - !str 'Foo'
+                    - true
+                    - 7
+                    - 3.14
+
                     # constants can be built-in, user-defined, or Enums
                     - !php/const true
                     - !php/const E_ALL
                     - !php/const PDO::FETCH_NUM
                     - !php/const App\Service\AnotherService::SOME_CONSTANT
                     - !php/const App\Config\SomeEnum::SomeCase
+
                     # when not using autowiring, you can pass service arguments explicitly
                     - '@some-service-id'  # the leading '@' tells this is a service ID, not a string
                     - '@?some-service-id' # using '?' means to pass null if service doesn't exist
+
+                    # binary contents are passed encoded as base64 strings
+                    - !!binary VGhpcyBpcyBhIEJlbGwgY2hhciAH
+
                     # collections (arrays) can include any type of argument
                     -
                         first: !php/const true
@@ -366,20 +373,30 @@ as arguments of other services:
 
             <services>
                 <service id="App\Service\SomeService">
-                    <!-- arguments without a type are treated as strings -->
+                    <!-- arguments without a type can be strings or numbers -->
                     <argument>Foo</argument>
+                    <argument>7</argument>
+                    <argument>3.14</argument>
                     <!-- explicitly declare a string argument -->
                     <argument type="string">Foo</argument>
+                    <!-- booleans are passed as constants -->
+                    <argument type="constant">true</argument>
+
                     <!-- constants can be built-in, user-defined, or Enums -->
                     <argument type="constant">true</argument>
                     <argument type="constant">E_ALL</argument>
                     <argument type="constant">PDO::FETCH_NUM</argument>
                     <argument type="constant">App\Service\AnotherService::SOME_CONSTANT</argument>
                     <argument type="constant">App\Config\SomeEnum::SomeCase</argument>
+
                     <!-- when not using autowiring, you can pass service arguments explicitly -->
                     <argument type="service"
                               id="some-service-id"
                               on-invalid="dependency_injection-ignore"/>
+
+                    <!-- binary contents are passed encoded as base64 strings -->
+                    <argument type="binary">VGhpcyBpcyBhIEJlbGwgY2hhciAH</argument>
+
                     <!-- collections (arrays) can include any type of argument -->
                     <argument type="collection">
                         <argument key="first" type="constant">true</argument>
@@ -402,18 +419,25 @@ as arguments of other services:
             $services = $container->services();
 
             $services->set(App\Service\SomeService::class)
-                // string arguments
+                // string, numeric and boolean arguments can be passed "as is"
                 ->arg(0, 'Foo')
-                // constants: built-in, user-defined, or Enums
                 ->arg(1, true)
-                ->arg(2, E_ALL)
-                ->arg(3, \PDO::FETCH_NUM)
-                ->arg(4, \App\Service\AnotherService::SOME_CONSTANT)
-                ->arg(5, \App\Config\SomeEnum::SomeCase)
-                // explicit service reference with on-invalid behavior
-                ->arg(6, new Reference('some-service-id', Reference::IGNORE_ON_INVALID_REFERENCE))
+                ->arg(2, 7)
+                ->arg(3, 3.14)
+
+                // constants: built-in, user-defined, or Enums
+                ->arg(4, E_ALL)
+                ->arg(5, \PDO::FETCH_NUM)
+                ->arg(6, \App\Service\AnotherService::SOME_CONSTANT)
+                ->arg(7, \App\Config\SomeEnum::SomeCase)
+
+                // when not using autowiring, you can pass service arguments explicitly
+                ->arg(8, service('some-service-id')) # fails if service doesn't exist
+                # passes null if service doesn't exist
+                ->arg(9, new Reference('some-service-id', Reference::IGNORE_ON_INVALID_REFERENCE))
+
                 // collection with mixed argument types
-                ->arg(7, [
+                ->arg(10, [
                     'first' => true,
                     'second' => 'Foo',
                 ]);