Merge pull request #36 from judgedim/master

Support for synthetic services

Author: mnapoli

README.md

@@ -488,6 +488,27 @@ services:
     app.phpmailer:
         class: AppBundle\Mail\PhpMailer
         shared: false
+``````
+
+#### Synthetic services
+
+Services can be injected [at runtime](http://symfony.com/doc/current/service_container/synthetic_services.html). You can inject a class instance as service, instead of configuring the container to create a new instance using the `synthetic()` function helper:
+
+```php
+return [
+    'app.phpmailer' => create(PhpMailer::class)
+        ->synthetic(),
+];
+```
+
+This is the same as:
+
+```yaml
+
+services:
+    app.phpmailer:
+        class: AppBundle\Mail\PhpMailer
+        synthetic: true
 ```
 
 ## Factories

src/DefinitionHelper/CreateDefinitionHelper.php

@@ -127,6 +127,16 @@ public function unshared() : self
         return $this;
     }
 
+    /**
+     * Marks the definition as synthetic
+     */
+    public function synthetic() : self
+    {
+        $this->definition->setSynthetic(true);
+
+        return $this;
+    }
+
     /**
      * Marks the definition as private
      */

src/DefinitionHelper/FactoryDefinitionHelper.php

@@ -50,4 +50,14 @@ public function arguments(...$arguments) : self
 
         return $this;
     }
+
+    /**
+     * Marks the definition as synthetic
+     */
+    public function synthetic() : self
+    {
+        $this->definition->setSynthetic(true);
+
+        return $this;
+    }
 }

tests/CreateTest.php

@@ -225,6 +225,19 @@ public function services_can_be_marked_as_unshared()
         self::assertFalse($container->get('bar') === $container->get('bar'));
     }
 
+    /** @test */
+    public function services_can_be_marked_as_synthetic()
+    {
+        $container = $this->createContainerWithConfig([
+            'bar' => create()
+                ->synthetic()
+        ]);
+
+        $foo = new \stdClass;
+        $container->set('bar', $foo);
+        self::assertInstanceOf('stdClass', $container->get('bar' ));
+    }
+
     /** @test */
     public function services_can_be_deprecated()
     {

tests/FactoryTest.php

@@ -62,6 +62,21 @@ public function parameters_can_be_injected_in_arguments()
         self::assertEquals('def', $container->get('foo')->arg1);
     }
 
+    /** @test */
+    public function services_can_be_marked_as_synthetic()
+    {
+        $container = $this->createContainerWithConfig([
+            'bar' => factory([self::class, 'foo'])
+                ->synthetic()
+        ]);
+        $foo = new class() {
+            public $foo;
+        };
+        $container->set('bar', $foo);
+        self::assertTrue(is_object($container->get('bar' )));
+        self::assertNotInstanceOf('stdClass', $container->get('bar' ));
+    }
+
     public static function foo()
     {
         return new \stdClass();