[symfony#3022] Adding a quick cookbook entry to highlight where the expression component is used in the framework

weaverryan · weaverryan · commit 33676dca47c4 · 2013-12-01T18:49:45.000-05:00
diff --git a/book/security.rst b/book/security.rst
@@ -953,6 +953,8 @@ address):
 
 * The second access rule is not examined as the first rule matched.
 
+.. _book-security-allow-if:
+
 Securing by an Expression
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/book/service_container.rst b/book/service_container.rst
@@ -627,6 +627,8 @@ service needs the ``my_mailer`` service in order to function. When you define
 this dependency in the service container, the container takes care of all
 the work of instantiating the classes.
 
+.. _book-services-expressions:
+
 Using the Expression Language
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/components/expression_language/introduction.rst b/components/expression_language/introduction.rst
@@ -3,7 +3,7 @@
     Single: Components; Expression Language
 
 The ExpressionLanguage Component
-=================================
+================================
 
     The ExpressionLanguage component provides an engine that can compile and
     evaluate expressions. An expression is a one-liner that returns a value
diff --git a/cookbook/expression/expressions.rst b/cookbook/expression/expressions.rst
@@ -0,0 +1,24 @@
+.. index::
+   single: Expressions in the Framework
+
+How to use Expressions in Security, Routing, Services, and Validation
+=====================================================================
+
+.. versionadded:: 2.4
+    The expression functionality was introduced in Symfony 2.4.
+
+In Symfony 2.4, a powerful :doc:`ExpressionLanguage </components/expression_language/introduction>`
+component was added to Symfony. This allows us to add highly customized
+logic inside configuration.
+
+The Symfony Framework leverages expressions out of the box in the following
+ways:
+
+* :ref:`Configuring services <book-services-expressions>`;
+* :ref:`Route matching conditions <book-routing-conditions>`;
+* :ref:`Checking security <book-security-expressions>` and
+  :ref:`access controls with allow_if <book-security-allow-if>`;
+* :doc:`Validation </reference/constraints/Expression>`.
+
+For more information about how to create and work with expressions, see
+:doc:`/components/expression_language/syntax`.
diff --git a/cookbook/expression/index.rst b/cookbook/expression/index.rst
@@ -0,0 +1,7 @@
+Expressions
+===========
+
+.. toctree::
+    :maxdepth: 2
+
+    expressions
diff --git a/cookbook/index.rst b/cookbook/index.rst
@@ -15,6 +15,7 @@ The Cookbook
     doctrine/index
     email/index
     event_dispatcher/index
+    expression/index
     form/index
     logging/index
     profiler/index
diff --git a/cookbook/map.rst.inc b/cookbook/map.rst.inc
@@ -78,6 +78,10 @@
   * :doc:`/cookbook/event_dispatcher/method_behavior`
   * (service container) :doc:`/cookbook/service_container/event_listener`
 
+* :doc:`/cookbook/expression/index`
+
+  * :doc:`/cookbook/expression/expressions`
+
 * :doc:`/cookbook/form/index`
 
   * :doc:`/cookbook/form/form_customization`
