Merge branch '4.1'

javiereguiluz · javiereguiluz · commit 5d5da2f4a584 · 2018-10-16T17:25:29.000+02:00
* 4.1:
  Add autoconfiguration note for MessageHandlers
  PhpFilesAdapter not invalidating cache
diff --git a/components/cache/adapters/php_files_adapter.rst b/components/cache/adapters/php_files_adapter.rst
@@ -33,6 +33,12 @@ file similar to the following::
     handles file includes, this adapter has the potential to be much faster than other
     filesystem-based caches.
 
+.. caution::
+
+    If you have configured OPcache to
+    :ref:`not check the file timestamps <performance-dont-check-timestamps>`
+    the cached items will not not be invalidated unless you clear OPcache.
+
 The PhpFilesAdapter can optionally be provided a namespace, default cache lifetime, and cache
 directory path as constructor arguments::
 
diff --git a/messenger.rst b/messenger.rst
@@ -49,15 +49,22 @@ message handler. It's a class with an ``__invoke`` method::
     // src/MessageHandler/MyMessageHandler.php
     namespace App\MessageHandler;
 
-    class MyMessageHandler
+    use Symfony\Component\Messenger\Handler;
+
+    class MyMessageHandler implements MessageHandlerInterface
     {
         public function __invoke(MyMessage $message)
         {
             // do something with it.
         }
     }
 
-Once you've created your handler, you need to register it:
+Message handlers must be registered as services and :doc:`tagged </service_container/tags>`
+with the ``messenger.message_handler`` tag. If you're using the
+:ref:`default services.yaml configuration <service-container-services-load-example>`,
+this is already done for you, thanks to :ref:`autoconfiguration <services-autoconfigure>`.
+
+If you're not using service autoconfiguration, then you need to add this config:
 
 .. configuration-block::
 

Original file line number	Diff line number	Diff line change
@@ -49,15 +49,22 @@ message handler. It's a class with an ``__invoke`` method::
`49`	`49`	`// src/MessageHandler/MyMessageHandler.php`
`50`	`50`	`namespace App\MessageHandler;`
`51`	`51`
`52`		`- class MyMessageHandler`
	`52`	`+ use Symfony\Component\Messenger\Handler;`
	`53`	`+`
	`54`	`+ class MyMessageHandler implements MessageHandlerInterface`
`53`	`55`	`{`
`54`	`56`	`public function __invoke(MyMessage $message)`
`55`	`57`	`{`
`56`	`58`	`// do something with it.`
`57`	`59`	`}`
`58`	`60`	`}`
`59`	`61`
`60`		`-Once you've created your handler, you need to register it:`
	`62`	+Message handlers must be registered as services and :doc:`tagged </service_container/tags>`
	`63`	+with the ``messenger.message_handler`` tag. If you're using the
	`64`	+:ref:`default services.yaml configuration <service-container-services-load-example>`,
	`65`	+this is already done for you, thanks to :ref:`autoconfiguration <services-autoconfigure>`.
	`66`	`+`
	`67`	`+If you're not using service autoconfiguration, then you need to add this config:`
`61`	`68`
`62`	`69`	`.. configuration-block::`
`63`	`70`