minor #6961 [Doctrine] Exception note about functions with named managers (rvanlaak)

xabbuh · xabbuh · commit e222c573d5da · 2016-11-05T13:03:58.000+01:00
This PR was merged into the 2.7 branch. Discussion ---------- [Doctrine] Exception note about functions with named managers In case the managers were defined/named explicitly, the DQL functions should also be defined over there. Commits ------- 075f56c [Doctrine] Exception note about functions with named managers
diff --git a/doctrine/custom_dql_functions.rst b/doctrine/custom_dql_functions.rst
@@ -69,4 +69,23 @@ In Symfony, you can register your custom DQL functions as follows:
             ),
         ));
 
+.. note::
+
+    In case the ``entity_managers`` were named explicitly, configuring the functions with the
+    orm directly will trigger the exception `Unrecognized option "dql" under "doctrine.orm"`.
+    The `dql` configuration block must be defined under the named entity manager.
+
+.. code-block:: yaml
+
+    # app/config/config.yml
+    doctrine:
+        orm:
+            # ...
+            entity_managers:
+                example_manager:
+                    # Place your functions here
+                    dql:
+                        datetime_functions:
+                            test_datetime: AppBundle\DQL\DatetimeFunction
+
 .. _`DQL User Defined Functions`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/cookbook/dql-user-defined-functions.html
