diff --git a/cookbook/configuration/index.rst b/cookbook/configuration/index.rst index 8bac5cf43be..11838c6fa38 100644 --- a/cookbook/configuration/index.rst +++ b/cookbook/configuration/index.rst @@ -9,8 +9,6 @@ Configuration using_parameters_in_dic front_controllers_and_kernel external_parameters - pdo_session_storage apache_router web_server_configuration configuration_organization - mongodb_session_storage \ No newline at end of file diff --git a/cookbook/controller/error_pages.rst b/cookbook/controller/error_pages.rst index a76fd767d24..e2a5de8acc3 100644 --- a/cookbook/controller/error_pages.rst +++ b/cookbook/controller/error_pages.rst @@ -233,7 +233,7 @@ before, but also requires a thorough understanding of Symfony internals. Suppose that your code throws specialized exceptions with a particular meaning to your application domain. -:doc:`Writing your own event listener ` +:doc:`Writing your own event listener ` for the ``kernel.exception`` event allows you to have a closer look at the exception and take different actions depending on it. Those actions might include logging the exception, redirecting the user to another page or rendering specialized diff --git a/cookbook/doctrine/index.rst b/cookbook/doctrine/index.rst index a62c736db11..d14ecb20536 100644 --- a/cookbook/doctrine/index.rst +++ b/cookbook/doctrine/index.rst @@ -14,4 +14,6 @@ Doctrine resolve_target_entity mapping_model_classes registration_form + pdo_session_storage + mongodb_session_storage console diff --git a/cookbook/configuration/mongodb_session_storage.rst b/cookbook/doctrine/mongodb_session_storage.rst similarity index 100% rename from cookbook/configuration/mongodb_session_storage.rst rename to cookbook/doctrine/mongodb_session_storage.rst diff --git a/cookbook/configuration/pdo_session_storage.rst b/cookbook/doctrine/pdo_session_storage.rst similarity index 100% rename from cookbook/configuration/pdo_session_storage.rst rename to cookbook/doctrine/pdo_session_storage.rst diff --git a/cookbook/event_dispatcher/before_after_filters.rst b/cookbook/event_dispatcher/before_after_filters.rst index d1c5acddbf8..2b7d25d6a9d 100644 --- a/cookbook/event_dispatcher/before_after_filters.rst +++ b/cookbook/event_dispatcher/before_after_filters.rst @@ -102,7 +102,7 @@ Creating an Event Listener Next, you'll need to create an event listener, which will hold the logic that you want executed before your controllers. If you're not familiar with -event listeners, you can learn more about them at :doc:`/cookbook/service_container/event_listener`:: +event listeners, you can learn more about them at :doc:`/cookbook/event_dispatcher/event_listener`:: // src/AppBundle/EventListener/TokenListener.php namespace AppBundle\EventListener; diff --git a/cookbook/service_container/event_listener.rst b/cookbook/event_dispatcher/event_listener.rst similarity index 100% rename from cookbook/service_container/event_listener.rst rename to cookbook/event_dispatcher/event_listener.rst diff --git a/cookbook/event_dispatcher/index.rst b/cookbook/event_dispatcher/index.rst index 8dfe9a541f4..27a9adfcc3d 100644 --- a/cookbook/event_dispatcher/index.rst +++ b/cookbook/event_dispatcher/index.rst @@ -4,6 +4,7 @@ Event Dispatcher .. toctree:: :maxdepth: 2 + event_listener before_after_filters class_extension method_behavior diff --git a/cookbook/map.rst.inc b/cookbook/map.rst.inc index 74048d3f60d..5ba5d97ff1c 100644 --- a/cookbook/map.rst.inc +++ b/cookbook/map.rst.inc @@ -34,11 +34,11 @@ * :doc:`/cookbook/configuration/using_parameters_in_dic` * :doc:`/cookbook/configuration/front_controllers_and_kernel` * :doc:`/cookbook/configuration/external_parameters` - * :doc:`/cookbook/configuration/pdo_session_storage` * :doc:`/cookbook/configuration/apache_router` * :doc:`/cookbook/configuration/web_server_configuration` * :doc:`/cookbook/configuration/configuration_organization` - * :doc:`/cookbook/configuration/mongodb_session_storage` + * (Doctrine) :doc:`/cookbook/doctrine/pdo_session_storage` + * (Doctrine) :doc:`/cookbook/doctrine/mongodb_session_storage` * :doc:`/cookbook/console/index` @@ -77,8 +77,9 @@ * :doc:`/cookbook/doctrine/resolve_target_entity` * :doc:`/cookbook/doctrine/mapping_model_classes` * :doc:`/cookbook/doctrine/registration_form` + * :doc:`/cookbook/doctrine/pdo_session_storage` + * :doc:`/cookbook/doctrine/mongodb_session_storage` * :doc:`/cookbook/doctrine/console` - * (configuration) :doc:`/cookbook/configuration/pdo_session_storage` * :doc:`/cookbook/email/index` @@ -94,7 +95,7 @@ * :doc:`/cookbook/event_dispatcher/before_after_filters` * :doc:`/cookbook/event_dispatcher/class_extension` * :doc:`/cookbook/event_dispatcher/method_behavior` - * (service container) :doc:`/cookbook/service_container/event_listener` + * :doc:`/cookbook/event_dispatcher/event_listener` * :doc:`/cookbook/form/index` @@ -108,8 +109,8 @@ * :doc:`/cookbook/form/unit_testing` * :doc:`/cookbook/form/use_empty_data` * :doc:`/cookbook/form/direct_submit` - * (validation) :doc:`/cookbook/validation/custom_constraint` - * (doctrine) :doc:`/cookbook/doctrine/file_uploads` + * (Validation) :doc:`/cookbook/validation/custom_constraint` + * (Doctrine) :doc:`/cookbook/doctrine/file_uploads` * :doc:`/cookbook/frontend/index` @@ -179,9 +180,9 @@ * :doc:`/cookbook/service_container/index` - * :doc:`/cookbook/service_container/event_listener` * :doc:`/cookbook/service_container/scopes` * :doc:`/cookbook/service_container/compiler_passes` + * (Event Dispatcher) :doc:`/cookbook/event_dispatcher/event_listener` * :doc:`/cookbook/session/index` @@ -189,9 +190,9 @@ * :doc:`/cookbook/session/locale_sticky_session` * :doc:`/cookbook/session/sessions_directory` * :doc:`/cookbook/session/php_bridge` - * (configuration) :doc:`/cookbook/configuration/pdo_session_storage` - * (configuration) :doc:`/cookbook/configuration/mongodb_session_storage` * :doc:`/cookbook/session/avoid_session_start` + * (Doctrine) :doc:`/cookbook/doctrine/pdo_session_storage` + * (Doctrine) :doc:`/cookbook/doctrine/mongodb_session_storage` * **PSR-7** diff --git a/cookbook/service_container/index.rst b/cookbook/service_container/index.rst index be8ad17868b..f66a455b788 100644 --- a/cookbook/service_container/index.rst +++ b/cookbook/service_container/index.rst @@ -4,6 +4,5 @@ Service Container .. toctree:: :maxdepth: 2 - event_listener scopes compiler_passes diff --git a/cookbook/session/locale_sticky_session.rst b/cookbook/session/locale_sticky_session.rst index c9ac75b55b9..978ab473764 100644 --- a/cookbook/session/locale_sticky_session.rst +++ b/cookbook/session/locale_sticky_session.rst @@ -14,7 +14,7 @@ Creating a LocaleListener ------------------------- To simulate that the locale is stored in a session, you need to create and -register a :doc:`new event listener `. +register a :doc:`new event listener `. The listener will look something like this. Typically, ``_locale`` is used as a routing parameter to signify the locale, though it doesn't really matter how you determine the desired locale from the request:: diff --git a/cookbook/session/sessions_directory.rst b/cookbook/session/sessions_directory.rst index 5ecc133ae9f..3b62b62cb95 100644 --- a/cookbook/session/sessions_directory.rst +++ b/cookbook/session/sessions_directory.rst @@ -94,8 +94,8 @@ that your current sessions aren't lost when you clear Symfony's cache. method of session management available within Symfony. See :doc:`/components/http_foundation/session_configuration` for a discussion of session save handlers. There are also entries in the cookbook - about storing sessions in a :doc:`relational database ` - or a :doc:`NoSQL database `. + about storing sessions in a :doc:`relational database ` + or a :doc:`NoSQL database `. To change the directory in which Symfony saves session data, you only need change the framework configuration. In this example, you will change the diff --git a/redirection_map b/redirection_map index 1ebc69ced38..2abbaf55500 100644 --- a/redirection_map +++ b/redirection_map @@ -26,3 +26,6 @@ /components/templating /components/templating/introduction /cookbook/upgrading /cookbook/upgrade/index /cookbook/security/voters_data_permission /cookbook/security/voters +/cookbook/configuration/pdo_session_storage /cookbook/doctrine/pdo_session_storage +/cookbook/configuration/mongodb_session_storage /cookbook/doctrine/mongodb_session_storage +/cookbook/service_container/event_listener /cookbook/event_dispatcher/event_listener diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst index 75af745849a..cace8c57949 100644 --- a/reference/configuration/framework.rst +++ b/reference/configuration/framework.rst @@ -713,7 +713,7 @@ installation. .. seealso:: You can see an example of the usage of this in - :doc:`/cookbook/configuration/pdo_session_storage`. + :doc:`/cookbook/doctrine/pdo_session_storage`. name .... diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst index 67a2a8aaa1b..fe56ed9ce3b 100644 --- a/reference/dic_tags.rst +++ b/reference/dic_tags.rst @@ -543,7 +543,7 @@ kernel.event_listener This tag allows you to hook your own classes into Symfony's process at different points. -For a full example of this listener, read the :doc:`/cookbook/service_container/event_listener` +For a full example of this listener, read the :doc:`/cookbook/event_dispatcher/event_listener` cookbook entry. For another practical example of a kernel listener, see the cookbook