From d2459f2d8e2af5c75db471fccee028dc583915f1 Mon Sep 17 00:00:00 2001 From: Martin Czerwinski Date: Thu, 29 Oct 2015 15:45:08 +0100 Subject: [PATCH 1/2] Added hints to spool config section The former explanation suggests that a single file is used for spooling, which is not the case of course. But I ran into that problem and since Symfony falls back to memory if the dir is not writable (as it seems) with no error message, this addition might help some people to get spools running. --- cookbook/email/spool.rst | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) diff --git a/cookbook/email/spool.rst b/cookbook/email/spool.rst index 3747f421f81..e7e4f81b9b8 100644 --- a/cookbook/email/spool.rst +++ b/cookbook/email/spool.rst @@ -55,10 +55,15 @@ swiftmailer with the memory option, use the following configuration: 'spool' => array('type' => 'memory') )); -Spool Using a File +Spool Using Files ------------------ -In order to use the spool with a file, use the following configuration: +When you use the filesystem for spooling, Symfony creates a folder in the given +path for each mail service (e.g. "default" for the default service). This folder +will contain files for each email in the spool. So make sure this directory is +writable by symfony (or your webserver/php)! + +In order to use the spool with files, use the following configuration: .. configuration-block:: @@ -69,7 +74,7 @@ In order to use the spool with a file, use the following configuration: # ... spool: type: file - path: /path/to/spool + path: /path/to/spooldir .. code-block:: xml @@ -84,7 +89,7 @@ In order to use the spool with a file, use the following configuration: @@ -97,7 +102,7 @@ In order to use the spool with a file, use the following configuration: 'spool' => array( 'type' => 'file', - 'path' => '/path/to/spool', + 'path' => '/path/to/spooldir', ), )); From a854c7fbd2a28aedf48b850649010a5c04ac95f3 Mon Sep 17 00:00:00 2001 From: Martin Czerwinski Date: Fri, 30 Oct 2015 11:29:11 +0100 Subject: [PATCH 2/2] Added label for the old headline and fixed a typo --- cookbook/email/spool.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/cookbook/email/spool.rst b/cookbook/email/spool.rst index e7e4f81b9b8..844b2454b8a 100644 --- a/cookbook/email/spool.rst +++ b/cookbook/email/spool.rst @@ -55,13 +55,15 @@ swiftmailer with the memory option, use the following configuration: 'spool' => array('type' => 'memory') )); +.. _spool-using-a-file: + Spool Using Files ------------------ When you use the filesystem for spooling, Symfony creates a folder in the given path for each mail service (e.g. "default" for the default service). This folder will contain files for each email in the spool. So make sure this directory is -writable by symfony (or your webserver/php)! +writable by Symfony (or your webserver/php)! In order to use the spool with files, use the following configuration: