minor #5637 Add QueryBuilder vs DQL section (bocharsky-bw)

xabbuh · xabbuh · commit c206a57e6ce2 · 2015-08-22T08:23:25.000+02:00
This PR was submitted for the master branch but it was merged into the 2.3 branch instead (closes #5637). Discussion ---------- Add QueryBuilder vs DQL section Describe difference between QueryBuilder and DQL usage. | Q | A | ------------- | --- | Doc fix? | no | New docs? | yes | Applies to | all | Fixed tickets | none Commits ------- cfc5873 Add explanation when to use QueryBuilder instead of DQL
diff --git a/book/doctrine.rst b/book/doctrine.rst
@@ -766,8 +766,10 @@ covered later), group, etc. For more information, see the official
 Querying for Objects Using Doctrine's Query Builder
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Instead of writing a DQL string, you can alternatively use a helpful object called
-the ``QueryBuilder`` to build that string for you::
+Instead of writing a DQL string, you can use a helpful object called the
+``QueryBuilder`` to build that string for you. This is useful when the actual query
+depends on dynamic conditions, as your code soon becomes hard to read with
+DQL as you start to concatenate strings::
 
     $repository = $this->getDoctrine()
         ->getRepository('AppBundle:Product');
