minor #6250 [Cookbook][Console] remove note about memory spool handling on CLI (xabbuh)

xabbuh · xabbuh · commit a0886879b11d · 2016-02-10T15:39:55.000+01:00
This PR was merged into the 2.3 branch. Discussion ---------- [Cookbook][Console] remove note about memory spool handling on CLI We added this note a long time ago in #4117, but I think we can now safely remove this part. Commits ------- 5eff7fd remove note about memory spool handling on CLI
diff --git a/book/routing.rst b/book/routing.rst
@@ -1514,7 +1514,7 @@ to ``generate()``:
     The host that's used when generating an absolute URL is automatically
     detected using the current ``Request`` object. When generating absolute
     URLs from outside the web context (for instance in a console command) this
-    doesn't work. See :doc:`/cookbook/console/sending_emails` to learn how to
+    doesn't work. See :doc:`/cookbook/console/request_context` to learn how to
     solve this problem.
 
 Summary
diff --git a/cookbook/console/index.rst b/cookbook/console/index.rst
@@ -7,5 +7,5 @@ Console
     console_command
     usage
     command_in_controller
-    sending_emails
+    request_context
     logging
diff --git a/cookbook/console/request_context.rst b/cookbook/console/request_context.rst
@@ -1,9 +1,8 @@
 .. index::
-   single: Console; Sending emails
    single: Console; Generating URLs
 
-How to Generate URLs and Send Emails from the Console
-=====================================================
+How to Generate URLs from the Console
+=====================================
 
 Unfortunately, the command line context does not know about your VirtualHost
 or domain name. This means that if you generate absolute URLs within a
@@ -84,43 +83,3 @@ from the ``router`` service and override its settings::
            // ... your code here
        }
    }
-
-Using Memory Spooling
----------------------
-
-.. versionadded:: 2.3
-    When using Symfony 2.3+ and SwiftmailerBundle 2.3.5+, the memory spool is now
-    handled automatically in the CLI and the code below is not necessary anymore.
-
-Sending emails in a console command works the same way as described in the
-:doc:`/cookbook/email/email` cookbook except if memory spooling is used.
-
-When using memory spooling (see the :doc:`/cookbook/email/spool` cookbook for more
-information), you must be aware that because of how Symfony handles console
-commands, emails are not sent automatically. You must take care of flushing
-the queue yourself. Use the following code to send emails inside your
-console command::
-
-    $message = new \Swift_Message();
-
-    // ... prepare the message
-
-    $container = $this->getContainer();
-    $mailer = $container->get('mailer');
-
-    $mailer->send($message);
-
-    // now manually flush the queue
-    $spool = $mailer->getTransport()->getSpool();
-    $transport = $container->get('swiftmailer.transport.real');
-
-    $spool->flushQueue($transport);
-
-Another option is to create an environment which is only used by console
-commands and uses a different spooling method.
-
-.. note::
-
-    Taking care of the spooling is only needed when memory spooling is used.
-    If you are using file spooling (or no spooling at all), there is no need
-    to flush the queue manually within the command.
diff --git a/cookbook/map.rst.inc b/cookbook/map.rst.inc
@@ -45,7 +45,7 @@
   * :doc:`/cookbook/console/console_command`
   * :doc:`/cookbook/console/usage`
   * :doc:`/cookbook/console/command_in_controller`
-  * :doc:`/cookbook/console/sending_emails`
+  * :doc:`/cookbook/console/request_context`
   * :doc:`/cookbook/console/logging`
 
 * :doc:`/cookbook/controller/index`
diff --git a/redirection_map b/redirection_map
@@ -1,5 +1,6 @@
 /book/stable_api /contributing/code/bc
 /book/internals /reference/events
+/cookbook/console/sending_emails /cookbook/console/request_context
 /cookbook/deployment-tools /cookbook/deployment/tools
 /cookbook/doctrine/migrations /bundles/DoctrineFixturesBundle/index
 /cookbook/doctrine/doctrine_fixtures /bundles/DoctrineFixturesBundle/index
