From d1f8e18d023bd50b0144d20fd8adbd6e49a6f450 Mon Sep 17 00:00:00 2001 From: Benjamin Eberlei Date: Sun, 7 Apr 2013 14:05:42 +0200 Subject: [PATCH] Enhance documentation on NEW() keyword. (ref DDC-1574) --- docs/en/reference/dql-doctrine-query-language.rst | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/en/reference/dql-doctrine-query-language.rst b/docs/en/reference/dql-doctrine-query-language.rst index b82cbabda..856a4b077 100644 --- a/docs/en/reference/dql-doctrine-query-language.rst +++ b/docs/en/reference/dql-doctrine-query-language.rst @@ -464,14 +464,15 @@ You use the partial syntax when joining as well: "NEW" Operator Syntax ^^^^^^^^^^^^^^^^^^^^^ -Using the ``NEW`` operator you can construct DTOs from queries. +.. versionadded:: 2.4 + +Using the ``NEW`` operator you can construct Data Transfer Objects (DTOs) directly from DQL queries. - When using ``SELECT NEW`` you don't need to specify a mapped entity. -- You can specify any PHP class, it's only require that you have a matching constructor in your class. +- You can specify any PHP class, it's only require that the constructor of this class matches the ``NEW`` statement. - This approach involves determining exactly which columns you really need, and instantiating data-transfer object that containing a constructor with those arguments. - If you want to select data-transfer objects you should create a class: .. code-block:: php