Merge pull request #7883 from cakephp/components-dic

Add documentation for DI + components

Author: dereuromark

en/appendices/5-1-migration-guide.rst

@@ -76,6 +76,12 @@ Core
   a typesafe way to cast request data or other input and return ``null`` when conversion fails.
 - ``pathCombine()`` was added to help build paths without worrying about duplicate and trailing slashes.
 
+Controller
+----------
+
+- Components can now use the DI container to have dependencies resolved and
+  provided as constructor parameters just like Controllers and Commands do.
+
 Database
 --------
 

en/controllers/components.rst

@@ -183,6 +183,29 @@ component would look something like this::
     All components must extend :php:class:`Cake\\Controller\\Component`. Failing
     to do this will trigger an exception.
 
+Components can use :doc:`/development/dependency-injection` to receive services
+as constructor parameters::
+
+    namespace App\Controller\Component;
+
+    use Cake\Controller\Component;
+    use App\Service\UserService;
+
+    class SsoComponent extends Component
+    {
+        public function __construct(
+            ComponentRegistry $registry,
+            array $config = [],
+            UserService $users
+        ) {
+            parent::__construct($registry, $config);
+            $this->users = $users;
+        }
+    }
+
+.. versionadded: 5.1.0
+   DI container support for Components was added.
+
 Including your Component in your Controllers
 --------------------------------------------