class DevelMailLogTest
Same name in other branches
- 4.x tests/src/Kernel/DevelMailLogTest.php \Drupal\Tests\devel\Kernel\DevelMailLogTest
- 5.x tests/src/Kernel/DevelMailLogTest.php \Drupal\Tests\devel\Kernel\DevelMailLogTest
Tests sending mails with debug interface.
@group devel
Hierarchy
- class \Drupal\Tests\devel\Kernel\DevelMailLogTest extends \Drupal\KernelTests\KernelTestBase
Expanded class hierarchy of DevelMailLogTest
File
-
tests/
src/ Kernel/ DevelMailLogTest.php, line 14
Namespace
Drupal\Tests\devel\KernelView source
class DevelMailLogTest extends KernelTestBase {
/**
* Modules to enable.
*
* @var array
*/
public static $modules = [
'devel',
'devel_test',
'system',
];
/**
* The mail manager.
*
* @var \Drupal\Core\Mail\MailManagerInterface
*/
protected $mailManager;
/**
* {@inheritdoc}
*/
protected function setUp() {
parent::setUp();
$this->installSchema('system', 'mail');
$this->installConfig([
'system',
'devel',
]);
// Configure system.site mail settings.
$this->config('system.site')
->set('mail', 'devel-test@example.com')
->save();
$this->mailManager = $this->container
->get('plugin.manager.mail');
}
/**
* Tests devel_mail_log plugin as default mail backend.
*/
public function testDevelMailLogDefaultBackend() {
// Configure devel_mail_log as default mail backends.
$this->setDevelMailLogAsDefaultBackend();
// Ensures that devel_mail_log is the default mail plugin .
$mail_backend = $this->mailManager
->getInstance([
'module' => 'default',
'key' => 'default',
]);
$this->assertInstanceOf(DevelMailLog::class, $mail_backend);
$mail_backend = $this->mailManager
->getInstance([
'module' => 'somemodule',
'key' => 'default',
]);
$this->assertInstanceOf(DevelMailLog::class, $mail_backend);
}
/**
* Tests devel_mail_log plugin with multiple mail backend.
*/
public function testDevelMailLogMultipleBackend() {
// Configure test_mail_collector as default mail backend.
$this->config('system.mail')
->set('interface.default', 'test_mail_collector')
->save();
// Configure devel_mail_log as a module-specific mail backend.
$this->config('system.mail')
->set('interface.somemodule', 'devel_mail_log')
->save();
// Ensures that devel_mail_log is not the default mail plugin.
$mail_backend = $this->mailManager
->getInstance([
'module' => 'default',
'key' => 'default',
]);
$this->assertInstanceOf(TestMailCollector::class, $mail_backend);
// Ensures that devel_mail_log is used as mail backend only for the
// specified module.
$mail_backend = $this->mailManager
->getInstance([
'module' => 'somemodule',
'key' => 'default',
]);
$this->assertInstanceOf(DevelMailLog::class, $mail_backend);
}
/**
* Tests devel_mail_log default settings.
*/
public function testDevelMailDefaultSettings() {
$config = \Drupal::config('devel.settings');
$this->assertEquals('temporary://devel-mails', $config->get('debug_mail_directory'));
$this->assertEquals('%to-%subject-%datetime.mail.txt', $config->get('debug_mail_file_format'));
}
/**
* Tests devel mail log output.
*/
public function testDevelMailLogOutput() {
$config = \Drupal::config('devel.settings');
// Parameters used for send the email.
$mail = [
'module' => 'devel_test',
'key' => 'devel_mail_log',
'to' => 'drupal@example.com',
'reply' => 'replyto@example.com',
'lang' => \Drupal::languageManager()->getCurrentLanguage(),
];
// Parameters used for compose the email in devel_test module.
// @see devel_test_mail()
$params = [
'subject' => 'Devel mail log subject',
'body' => 'Devel mail log body',
'headers' => [
'from' => 'postmaster@example.com',
'additional' => [
'X-stupid' => 'dumb',
],
],
];
// Configure devel_mail_log as default mail backends.
$this->setDevelMailLogAsDefaultBackend();
// Changes the default filename pattern removing the dynamic date
// placeholder for a more predictable filename output.
$random = $this->randomMachineName();
$filename_pattern = '%to-%subject-' . $random . '.mail.txt';
$this->config('devel.settings')
->set('debug_mail_file_format', $filename_pattern)
->save();
$expected_filename = 'drupal@example.com-Devel_mail_log_subject-' . $random . '.mail.txt';
$expected_output = <<<EOF
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8; format=flowed; delsp=yes
Content-Transfer-Encoding: 8Bit
X-Mailer: Drupal
Return-Path: devel-test@example.com
Sender: devel-test@example.com
From: postmaster@example.com
Reply-to: replyto@example.com
X-stupid: dumb
To: drupal@example.com
Subject: Devel mail log subject
Devel mail log body
EOF;
// Ensures that the mail is captured by devel_mail_log and the placeholders
// in the filename are properly resolved.
$default_output_directory = $config->get('debug_mail_directory');
$expected_file_path = $default_output_directory . '/' . $expected_filename;
$this->mailManager
->mail($mail['module'], $mail['key'], $mail['to'], $mail['lang'], $params, $mail['reply']);
$this->assertFileExists($expected_file_path);
$this->assertStringEqualsFile($expected_file_path, $expected_output);
// Ensures that even changing the default output directory devel_mail_log
// works as expected.
$changed_output_directory = 'temporary://my-folder';
$expected_file_path = $changed_output_directory . '/' . $expected_filename;
$this->config('devel.settings')
->set('debug_mail_directory', $changed_output_directory)
->save();
$result = $this->mailManager
->mail($mail['module'], $mail['key'], $mail['to'], $mail['lang'], $params, $mail['reply']);
$this->assertSame(TRUE, $result['result']);
$this->assertFileExists($expected_file_path);
$this->assertStringEqualsFile($expected_file_path, $expected_output);
// Ensures that if the default output directory is a public directory it
// will be protected by adding an .htaccess.
$public_output_directory = 'public://my-folder';
$expected_file_path = $public_output_directory . '/' . $expected_filename;
$this->config('devel.settings')
->set('debug_mail_directory', $public_output_directory)
->save();
$this->mailManager
->mail($mail['module'], $mail['key'], $mail['to'], $mail['lang'], $params, $mail['reply']);
$this->assertFileExists($expected_file_path);
$this->assertStringEqualsFile($expected_file_path, $expected_output);
$this->assertFileExists($public_output_directory . '/.htaccess');
}
/**
* Configure devel_mail_log as default mail backend.
*/
private function setDevelMailLogAsDefaultBackend() {
// TODO can this be avoided?
// KernelTestBase enforce the usage of 'test_mail_collector' plugin for
// collect the mails. Since we need to test devel mail plugin we manually
// configure the mail implementation to use 'devel_mail_log'.
$GLOBALS['config']['system.mail']['interface']['default'] = 'devel_mail_log';
// Configure devel_mail_log as default mail backend.
$this->config('system.mail')
->set('interface.default', 'devel_mail_log')
->save();
}
}
Members
Title Sort descending | Modifiers | Object type | Summary |
---|---|---|---|
DevelMailLogTest::$mailManager | protected | property | The mail manager. |
DevelMailLogTest::$modules | public static | property | Modules to enable. |
DevelMailLogTest::setDevelMailLogAsDefaultBackend | private | function | Configure devel_mail_log as default mail backend. |
DevelMailLogTest::setUp | protected | function | |
DevelMailLogTest::testDevelMailDefaultSettings | public | function | Tests devel_mail_log default settings. |
DevelMailLogTest::testDevelMailLogDefaultBackend | public | function | Tests devel_mail_log plugin as default mail backend. |
DevelMailLogTest::testDevelMailLogMultipleBackend | public | function | Tests devel_mail_log plugin with multiple mail backend. |
DevelMailLogTest::testDevelMailLogOutput | public | function | Tests devel mail log output. |