class MailManagerTest
Same name in other branches
- 9 core/tests/Drupal/Tests/Core/Mail/MailManagerTest.php \Drupal\Tests\Core\Mail\MailManagerTest
- 8.9.x core/tests/Drupal/Tests/Core/Mail/MailManagerTest.php \Drupal\Tests\Core\Mail\MailManagerTest
- 10 core/tests/Drupal/Tests/Core/Mail/MailManagerTest.php \Drupal\Tests\Core\Mail\MailManagerTest
@coversDefaultClass \Drupal\Core\Mail\MailManager @group Mail
Hierarchy
- class \Drupal\Tests\UnitTestCase extends \PHPUnit\Framework\TestCase uses \Drupal\Tests\PhpUnitCompatibilityTrait, \Prophecy\PhpUnit\ProphecyTrait, \Drupal\TestTools\Extension\DeprecationBridge\ExpectDeprecationTrait, \Drupal\Tests\RandomGeneratorTrait
- class \Drupal\Tests\Core\Mail\MailManagerTest extends \Drupal\Tests\UnitTestCase
Expanded class hierarchy of MailManagerTest
File
-
core/
tests/ Drupal/ Tests/ Core/ Mail/ MailManagerTest.php, line 20
Namespace
Drupal\Tests\Core\MailView source
class MailManagerTest extends UnitTestCase {
/**
* The cache backend to use.
*
* @var \Drupal\Core\Cache\CacheBackendInterface|\PHPUnit\Framework\MockObject\MockObject
*/
protected $cache;
/**
* The module handler.
*
* @var \Drupal\Core\Extension\ModuleHandlerInterface|\PHPUnit\Framework\MockObject\MockObject
*/
protected $moduleHandler;
/**
* The configuration factory.
*
* @var \Drupal\Core\Config\ConfigFactoryInterface|\PHPUnit\Framework\MockObject\MockObject
*/
protected $configFactory;
/**
* The plugin discovery.
*
* @var \Drupal\Component\Plugin\Discovery\DiscoveryInterface|\PHPUnit\Framework\MockObject\MockObject
*/
protected $discovery;
/**
* The renderer.
*
* @var \Drupal\Core\Render\RendererInterface|\PHPUnit\Framework\MockObject\MockObject
*/
protected $renderer;
/**
* The mail manager under test.
*
* @var \Drupal\Tests\Core\Mail\TestMailManager
*/
protected $mailManager;
/**
* The request stack.
*
* @var \Symfony\Component\HttpFoundation\RequestStack|\Prophecy\Prophecy\ProphecyInterface
*/
protected $requestStack;
/**
* The current request.
*
* @var \Symfony\Component\HttpFoundation\Request
*/
protected $request;
/**
* A list of mail plugin definitions.
*
* @var array
*/
protected $definitions = [
'php_mail' => [
'id' => 'php_mail',
'class' => 'Drupal\\Core\\Mail\\Plugin\\Mail\\PhpMail',
],
'test_mail_collector' => [
'id' => 'test_mail_collector',
'class' => 'Drupal\\Core\\Mail\\Plugin\\Mail\\TestMailCollector',
],
];
/**
* {@inheritdoc}
*/
protected function setUp() : void {
parent::setUp();
// Prepare the default constructor arguments required by MailManager.
$this->cache = $this->createMock('Drupal\\Core\\Cache\\CacheBackendInterface');
$this->moduleHandler = $this->createMock('Drupal\\Core\\Extension\\ModuleHandlerInterface');
// Mock a Discovery object to replace AnnotationClassDiscovery.
$this->discovery = $this->createMock('Drupal\\Component\\Plugin\\Discovery\\DiscoveryInterface');
$this->discovery
->expects($this->any())
->method('getDefinitions')
->willReturn($this->definitions);
}
/**
* Sets up the mail manager for testing.
*/
protected function setUpMailManager($interface = []) : void {
// Use the provided config for system.mail.interface settings.
$this->configFactory = $this->getConfigFactoryStub([
'system.mail' => [
'interface' => $interface,
'mailer_dsn' => [
'scheme' => 'null',
'host' => 'null',
'user' => NULL,
'password' => NULL,
'port' => NULL,
'options' => [],
],
],
'system.site' => [
'mail' => 'test@example.com',
],
]);
$logger_factory = $this->createMock('\\Drupal\\Core\\Logger\\LoggerChannelFactoryInterface');
$string_translation = $this->getStringTranslationStub();
$this->renderer = $this->createMock(RendererInterface::class);
// Construct the manager object and override its discovery.
$this->mailManager = new TestMailManager(new \ArrayObject(), $this->cache, $this->moduleHandler, $this->configFactory, $logger_factory, $string_translation, $this->renderer);
$this->mailManager
->setDiscovery($this->discovery);
$this->request = new Request();
$this->requestStack = $this->prophesize(RequestStack::class);
$this->requestStack
->getCurrentRequest()
->willReturn($this->request);
// @see \Drupal\Core\Plugin\Factory\ContainerFactory::createInstance()
$container = new ContainerBuilder();
$container->set('config.factory', $this->configFactory);
$container->set('request_stack', $this->requestStack
->reveal());
\Drupal::setContainer($container);
}
/**
* Tests the getInstance method.
*
* @covers ::getInstance
*/
public function testGetInstance() : void {
$interface = [
'default' => 'php_mail',
'example_test_key' => 'test_mail_collector',
];
$this->setUpMailManager($interface);
// Test that an unmatched message_id returns the default plugin instance.
$options = [
'module' => 'foo',
'key' => 'bar',
];
$instance = $this->mailManager
->getInstance($options);
$this->assertInstanceOf('Drupal\\Core\\Mail\\Plugin\\Mail\\PhpMail', $instance);
// Test that a matching message_id returns the specified plugin instance.
$options = [
'module' => 'example',
'key' => 'test_key',
];
$instance = $this->mailManager
->getInstance($options);
$this->assertInstanceOf('Drupal\\Core\\Mail\\Plugin\\Mail\\TestMailCollector', $instance);
}
/**
* Tests that mails are sent in a separate render context.
*
* @covers ::mail
*/
public function testMailInRenderContext() : void {
$interface = [
'default' => 'php_mail',
'example_test_key' => 'test_mail_collector',
];
$this->setUpMailManager($interface);
$this->renderer
->expects($this->exactly(1))
->method('executeInRenderContext')
->willReturnCallback(function (RenderContext $render_context, $callback) {
$message = $callback();
$this->assertEquals('example', $message['module']);
});
$this->mailManager
->mail('example', 'key', 'to@example.org', 'en');
}
}
Members
Title Sort descending | Modifiers | Object type | Summary | Overriden Title |
---|---|---|---|---|
ExpectDeprecationTrait::expectDeprecation | public | function | Adds an expected deprecation. | |
ExpectDeprecationTrait::getCallableName | private static | function | Returns a callable as a string suitable for inclusion in a message. | |
ExpectDeprecationTrait::setUpErrorHandler | public | function | Sets up the test error handler. | |
ExpectDeprecationTrait::tearDownErrorHandler | public | function | Tears down the test error handler. | |
MailManagerTest::$cache | protected | property | The cache backend to use. | |
MailManagerTest::$configFactory | protected | property | The configuration factory. | |
MailManagerTest::$definitions | protected | property | A list of mail plugin definitions. | |
MailManagerTest::$discovery | protected | property | The plugin discovery. | |
MailManagerTest::$mailManager | protected | property | The mail manager under test. | |
MailManagerTest::$moduleHandler | protected | property | The module handler. | |
MailManagerTest::$renderer | protected | property | The renderer. | |
MailManagerTest::$request | protected | property | The current request. | |
MailManagerTest::$requestStack | protected | property | The request stack. | |
MailManagerTest::setUp | protected | function | Overrides UnitTestCase::setUp | |
MailManagerTest::setUpMailManager | protected | function | Sets up the mail manager for testing. | |
MailManagerTest::testGetInstance | public | function | Tests the getInstance method. | |
MailManagerTest::testMailInRenderContext | public | function | Tests that mails are sent in a separate render context. | |
RandomGeneratorTrait::getRandomGenerator | protected | function | Gets the random generator for the utility methods. | |
RandomGeneratorTrait::randomMachineName | protected | function | Generates a unique random string containing letters and numbers. | |
RandomGeneratorTrait::randomObject | public | function | Generates a random PHP object. | |
RandomGeneratorTrait::randomString | public | function | Generates a pseudo-random string of ASCII characters of codes 32 to 126. | |
UnitTestCase::$root | protected | property | The app root. | |
UnitTestCase::getClassResolverStub | protected | function | Returns a stub class resolver. | |
UnitTestCase::getConfigFactoryStub | public | function | Returns a stub config factory that behaves according to the passed array. | |
UnitTestCase::getConfigStorageStub | public | function | Returns a stub config storage that returns the supplied configuration. | |
UnitTestCase::getContainerWithCacheTagsInvalidator | protected | function | Sets up a container with a cache tags invalidator. | |
UnitTestCase::getStringTranslationStub | public | function | Returns a stub translation manager that just returns the passed string. | |
UnitTestCase::setUpBeforeClass | public static | function |
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.