1
|
|
|
<?php |
2
|
|
|
|
3
|
|
|
/* |
4
|
|
|
* This file is part of the Liip/FunctionalTestBundle |
5
|
|
|
* |
6
|
|
|
* (c) Lukas Kahwe Smith <[email protected]> |
7
|
|
|
* |
8
|
|
|
* This source file is subject to the MIT license that is bundled |
9
|
|
|
* with this source code in the file LICENSE. |
10
|
|
|
*/ |
11
|
|
|
|
12
|
|
|
namespace Liip\FunctionalTestBundle\Test; |
13
|
|
|
|
14
|
|
|
use Symfony\Bundle\FrameworkBundle\Test\WebTestCase as BaseWebTestCase; |
15
|
|
|
use Symfony\Bundle\FrameworkBundle\Console\Application; |
16
|
|
|
use Symfony\Bundle\FrameworkBundle\Client; |
17
|
|
|
use Symfony\Component\Console\Input\ArrayInput; |
18
|
|
|
use Symfony\Component\Console\Output\OutputInterface; |
19
|
|
|
use Symfony\Component\Console\Output\StreamOutput; |
20
|
|
|
use Symfony\Component\DomCrawler\Crawler; |
21
|
|
|
use Symfony\Component\BrowserKit\Cookie; |
22
|
|
|
use Symfony\Component\HttpKernel\Kernel; |
23
|
|
|
use Symfony\Component\HttpFoundation\Response; |
24
|
|
|
use Symfony\Component\Security\Core\Authentication\Token\TokenInterface; |
25
|
|
|
use Symfony\Component\Security\Core\User\UserInterface; |
26
|
|
|
use Symfony\Component\Security\Core\Authentication\Token\UsernamePasswordToken; |
27
|
|
|
use Symfony\Component\DependencyInjection\ContainerInterface; |
28
|
|
|
use Symfony\Component\HttpFoundation\Session\Session; |
29
|
|
|
use Symfony\Component\Routing\Generator\UrlGeneratorInterface; |
30
|
|
|
use Symfony\Bridge\Doctrine\ManagerRegistry; |
31
|
|
|
use Symfony\Bundle\DoctrineFixturesBundle\Common\DataFixtures\Loader; |
32
|
|
|
use Doctrine\Common\Persistence\ObjectManager; |
33
|
|
|
use Doctrine\Common\DataFixtures\DependentFixtureInterface; |
34
|
|
|
use Doctrine\Common\DataFixtures\Executor\AbstractExecutor; |
35
|
|
|
use Doctrine\Common\DataFixtures\ProxyReferenceRepository; |
36
|
|
|
use Doctrine\DBAL\Driver\PDOSqlite\Driver as SqliteDriver; |
37
|
|
|
use Doctrine\DBAL\Platforms\MySqlPlatform; |
38
|
|
|
use Doctrine\ORM\EntityManager; |
39
|
|
|
use Doctrine\ORM\Tools\SchemaTool; |
40
|
|
|
use Nelmio\Alice\Fixtures; |
41
|
|
|
use Liip\FunctionalTestBundle\Utils\HttpAssertions; |
42
|
|
|
|
43
|
|
|
/** |
44
|
|
|
* @author Lea Haensenberger |
45
|
|
|
* @author Lukas Kahwe Smith <[email protected]> |
46
|
|
|
* @author Benjamin Eberlei <[email protected]> |
47
|
|
|
*/ |
48
|
|
|
abstract class WebTestCase extends BaseWebTestCase |
49
|
|
|
{ |
50
|
|
|
protected $environment = 'test'; |
51
|
|
|
protected $containers; |
52
|
|
|
protected $kernelDir; |
53
|
|
|
// 5 * 1024 * 1024 KB |
54
|
|
|
protected $maxMemory = 5242880; |
55
|
|
|
|
56
|
|
|
// RUN COMMAND |
57
|
|
|
protected $verbosityLevel; |
58
|
|
|
protected $decorated; |
59
|
|
|
|
60
|
|
|
/** |
61
|
|
|
* @var array |
62
|
|
|
*/ |
63
|
|
|
private $firewallLogins = array(); |
64
|
|
|
|
65
|
|
|
/** |
66
|
|
|
* @var array |
67
|
|
|
*/ |
68
|
|
|
private $excludedDoctrineTables = array(); |
69
|
|
|
|
70
|
|
|
/** |
71
|
|
|
* @var array |
72
|
|
|
*/ |
73
|
|
|
private static $cachedMetadatas = array(); |
74
|
|
|
|
75
|
|
|
protected static function getKernelClass() |
|
|
|
|
76
|
|
|
{ |
77
|
|
|
$dir = isset($_SERVER['KERNEL_DIR']) ? $_SERVER['KERNEL_DIR'] : static::getPhpUnitXmlDir(); |
78
|
|
|
|
79
|
|
|
list($appname) = explode('\\', get_called_class()); |
80
|
|
|
|
81
|
|
|
$class = $appname.'Kernel'; |
82
|
|
|
$file = $dir.'/'.strtolower($appname).'/'.$class.'.php'; |
83
|
|
|
if (!file_exists($file)) { |
84
|
|
|
return parent::getKernelClass(); |
85
|
|
|
} |
86
|
|
|
require_once $file; |
87
|
|
|
|
88
|
|
|
return $class; |
89
|
|
|
} |
90
|
|
|
|
91
|
|
|
/** |
92
|
|
|
* Creates a mock object of a service identified by its id. |
93
|
|
|
* |
94
|
|
|
* @param string $id |
95
|
|
|
* |
96
|
|
|
* @return \PHPUnit_Framework_MockObject_MockBuilder |
97
|
|
|
*/ |
98
|
|
|
protected function getServiceMockBuilder($id) |
99
|
|
|
{ |
100
|
|
|
$service = $this->getContainer()->get($id); |
101
|
|
|
$class = get_class($service); |
102
|
|
|
|
103
|
|
|
return $this->getMockBuilder($class)->disableOriginalConstructor(); |
104
|
|
|
} |
105
|
|
|
|
106
|
|
|
/** |
107
|
|
|
* Builds up the environment to run the given command. |
108
|
|
|
* |
109
|
|
|
* @param string $name |
110
|
|
|
* @param array $params |
111
|
|
|
* @param bool $reuseKernel |
112
|
|
|
* |
113
|
|
|
* @return string |
114
|
|
|
*/ |
115
|
12 |
|
protected function runCommand($name, array $params = array(), $reuseKernel = false) |
116
|
|
|
{ |
117
|
12 |
|
array_unshift($params, $name); |
118
|
|
|
|
119
|
12 |
|
if (!$reuseKernel) { |
120
|
12 |
|
if (null !== static::$kernel) { |
121
|
9 |
|
static::$kernel->shutdown(); |
122
|
9 |
|
} |
123
|
|
|
|
124
|
12 |
|
$kernel = static::$kernel = $this->createKernel(array('environment' => $this->environment)); |
125
|
12 |
|
$kernel->boot(); |
126
|
12 |
|
} else { |
127
|
2 |
|
$kernel = $this->getContainer()->get('kernel'); |
128
|
|
|
} |
129
|
|
|
|
130
|
12 |
|
$application = new Application($kernel); |
131
|
12 |
|
$application->setAutoExit(false); |
132
|
|
|
|
133
|
|
|
// @codeCoverageIgnoreStart |
134
|
|
|
if ('203' === substr(Kernel::VERSION_ID, 0, 3)) { |
135
|
|
|
$params = $this->configureVerbosityForSymfony203($params); |
136
|
|
|
} |
137
|
|
|
// @codeCoverageIgnoreEnd |
138
|
|
|
|
139
|
12 |
|
$input = new ArrayInput($params); |
140
|
12 |
|
$input->setInteractive(false); |
141
|
|
|
|
142
|
12 |
|
$fp = fopen('php://temp/maxmemory:'.$this->maxMemory, 'r+'); |
143
|
12 |
|
$output = new StreamOutput($fp, $this->getVerbosityLevel(), $this->getDecorated()); |
144
|
|
|
|
145
|
11 |
|
$application->run($input, $output); |
146
|
|
|
|
147
|
11 |
|
rewind($fp); |
148
|
|
|
|
149
|
11 |
|
return stream_get_contents($fp); |
150
|
|
|
} |
151
|
|
|
|
152
|
|
|
/** |
153
|
|
|
* Retrieves the output verbosity level. |
154
|
|
|
* |
155
|
|
|
* @see Symfony\Component\Console\Output\OutputInterface for available levels |
156
|
|
|
* |
157
|
|
|
* @return int |
158
|
|
|
* |
159
|
|
|
* @throws \OutOfBoundsException If the set value isn't accepted |
160
|
|
|
*/ |
161
|
12 |
|
protected function getVerbosityLevel() |
162
|
|
|
{ |
163
|
|
|
// If `null`, is not yet set |
164
|
12 |
|
if (null === $this->verbosityLevel) { |
165
|
|
|
// Set the global verbosity level that is set as NORMAL by the TreeBuilder in Configuration |
166
|
6 |
|
$level = strtoupper($this->getContainer()->getParameter('liip_functional_test.command_verbosity')); |
167
|
6 |
|
$verbosity = '\Symfony\Component\Console\Output\StreamOutput::VERBOSITY_'.$level; |
168
|
|
|
|
169
|
6 |
|
$this->verbosityLevel = constant($verbosity); |
170
|
6 |
|
} |
171
|
|
|
|
172
|
|
|
// If string, it is set by the developer, so check that the value is an accepted one |
173
|
12 |
|
if (is_string($this->verbosityLevel)) { |
174
|
6 |
|
$level = strtoupper($this->verbosityLevel); |
175
|
6 |
|
$verbosity = '\Symfony\Component\Console\Output\StreamOutput::VERBOSITY_'.$level; |
176
|
|
|
|
177
|
6 |
|
if (!defined($verbosity)) { |
178
|
1 |
|
throw new \OutOfBoundsException( |
179
|
1 |
|
sprintf('The set value "%s" for verbosityLevel is not valid. Accepted are: "quiet", "normal", "verbose", "very_verbose" and "debug".', $level) |
180
|
1 |
|
); |
181
|
|
|
} |
182
|
|
|
|
183
|
5 |
|
$this->verbosityLevel = constant($verbosity); |
184
|
5 |
|
} |
185
|
|
|
|
186
|
11 |
|
return $this->verbosityLevel; |
187
|
|
|
} |
188
|
|
|
|
189
|
|
|
/** |
190
|
|
|
* In Symfony 2.3.* the verbosity level has to be set through {Symfony\Component\Console\Input\ArrayInput} and not |
191
|
|
|
* in {Symfony\Component\Console\Output\OutputInterface}. |
192
|
|
|
* |
193
|
|
|
* This method builds $params to be passed to {Symfony\Component\Console\Input\ArrayInput}. |
194
|
|
|
* |
195
|
|
|
* @codeCoverageIgnore |
196
|
|
|
* |
197
|
|
|
* @param array $params |
198
|
|
|
* |
199
|
|
|
* @return array |
200
|
|
|
*/ |
201
|
|
|
private function configureVerbosityForSymfony203(array $params) |
202
|
|
|
{ |
203
|
|
|
switch ($this->getVerbosityLevel()) { |
204
|
|
|
case OutputInterface::VERBOSITY_QUIET: |
205
|
|
|
$params['-q'] = '-q'; |
206
|
|
|
break; |
207
|
|
|
|
208
|
|
|
case OutputInterface::VERBOSITY_VERBOSE: |
209
|
|
|
$params['-v'] = ''; |
210
|
|
|
break; |
211
|
|
|
|
212
|
|
|
case OutputInterface::VERBOSITY_VERY_VERBOSE: |
213
|
|
|
$params['-vv'] = ''; |
214
|
|
|
break; |
215
|
|
|
|
216
|
|
|
case OutputInterface::VERBOSITY_DEBUG: |
217
|
|
|
$params['-vvv'] = ''; |
218
|
|
|
break; |
219
|
|
|
} |
220
|
|
|
|
221
|
|
|
return $params; |
222
|
|
|
} |
223
|
|
|
|
224
|
6 |
|
public function setVerbosityLevel($level) |
225
|
|
|
{ |
226
|
6 |
|
$this->verbosityLevel = $level; |
227
|
6 |
|
} |
228
|
|
|
|
229
|
|
|
/** |
230
|
|
|
* Retrieves the flag indicating if the output should be decorated or not. |
231
|
|
|
* |
232
|
|
|
* @return bool |
233
|
|
|
*/ |
234
|
11 |
|
protected function getDecorated() |
235
|
|
|
{ |
236
|
11 |
|
if (null === $this->decorated) { |
237
|
|
|
// Set the global decoration flag that is set to `true` by the TreeBuilder in Configuration |
238
|
5 |
|
$this->decorated = $this->getContainer()->getParameter('liip_functional_test.command_decoration'); |
239
|
5 |
|
} |
240
|
|
|
|
241
|
|
|
// Check the local decorated flag |
242
|
11 |
|
if (false === is_bool($this->decorated)) { |
243
|
|
|
throw new \OutOfBoundsException( |
244
|
|
|
sprintf('`WebTestCase::decorated` has to be `bool`. "%s" given.', gettype($this->decorated)) |
245
|
|
|
); |
246
|
|
|
} |
247
|
|
|
|
248
|
11 |
|
return $this->decorated; |
249
|
|
|
} |
250
|
|
|
|
251
|
6 |
|
public function isDecorated($decorated) |
252
|
|
|
{ |
253
|
6 |
|
$this->decorated = $decorated; |
254
|
6 |
|
} |
255
|
|
|
|
256
|
|
|
/** |
257
|
|
|
* Get an instance of the dependency injection container. |
258
|
|
|
* (this creates a kernel *without* parameters). |
259
|
|
|
* |
260
|
|
|
* @return ContainerInterface |
261
|
|
|
*/ |
262
|
49 |
|
protected function getContainer() |
|
|
|
|
263
|
|
|
{ |
264
|
49 |
|
if (!empty($this->kernelDir)) { |
265
|
|
|
$tmpKernelDir = isset($_SERVER['KERNEL_DIR']) ? $_SERVER['KERNEL_DIR'] : null; |
266
|
|
|
$_SERVER['KERNEL_DIR'] = getcwd().$this->kernelDir; |
267
|
|
|
} |
268
|
|
|
|
269
|
49 |
|
$cacheKey = $this->kernelDir.'|'.$this->environment; |
270
|
49 |
|
if (empty($this->containers[$cacheKey])) { |
271
|
|
|
$options = array( |
272
|
48 |
|
'environment' => $this->environment, |
273
|
48 |
|
); |
274
|
48 |
|
$kernel = $this->createKernel($options); |
275
|
48 |
|
$kernel->boot(); |
276
|
|
|
|
277
|
48 |
|
$this->containers[$cacheKey] = $kernel->getContainer(); |
278
|
48 |
|
} |
279
|
|
|
|
280
|
49 |
|
if (isset($tmpKernelDir)) { |
281
|
|
|
$_SERVER['KERNEL_DIR'] = $tmpKernelDir; |
282
|
|
|
} |
283
|
|
|
|
284
|
49 |
|
return $this->containers[$cacheKey]; |
285
|
|
|
} |
286
|
|
|
|
287
|
|
|
/** |
288
|
|
|
* This function finds the time when the data blocks of a class definition |
289
|
|
|
* file were being written to, that is, the time when the content of the |
290
|
|
|
* file was changed. |
291
|
|
|
* |
292
|
|
|
* @param string $class The fully qualified class name of the fixture class to |
293
|
|
|
* check modification date on |
294
|
|
|
* |
295
|
|
|
* @return \DateTime|null |
296
|
|
|
*/ |
297
|
3 |
|
protected function getFixtureLastModified($class) |
298
|
|
|
{ |
299
|
3 |
|
$lastModifiedDateTime = null; |
300
|
|
|
|
301
|
3 |
|
$reflClass = new \ReflectionClass($class); |
302
|
3 |
|
$classFileName = $reflClass->getFileName(); |
303
|
|
|
|
304
|
3 |
|
if (file_exists($classFileName)) { |
305
|
3 |
|
$lastModifiedDateTime = new \DateTime(); |
306
|
3 |
|
$lastModifiedDateTime->setTimestamp(filemtime($classFileName)); |
307
|
3 |
|
} |
308
|
|
|
|
309
|
3 |
|
return $lastModifiedDateTime; |
310
|
|
|
} |
311
|
|
|
|
312
|
|
|
/** |
313
|
|
|
* Determine if the Fixtures that define a database backup have been |
314
|
|
|
* modified since the backup was made. |
315
|
|
|
* |
316
|
|
|
* @param array $classNames The fixture classnames to check |
317
|
|
|
* @param string $backup The fixture backup SQLite database file path |
318
|
|
|
* |
319
|
|
|
* @return bool TRUE if the backup was made since the modifications to the |
320
|
|
|
* fixtures; FALSE otherwise |
321
|
|
|
*/ |
322
|
7 |
|
protected function isBackupUpToDate(array $classNames, $backup) |
323
|
|
|
{ |
324
|
7 |
|
$backupLastModifiedDateTime = new \DateTime(); |
325
|
7 |
|
$backupLastModifiedDateTime->setTimestamp(filemtime($backup)); |
326
|
|
|
|
327
|
|
|
/** @var \Symfony\Bridge\Doctrine\DataFixtures\ContainerAwareLoader $loader */ |
328
|
7 |
|
$loader = $this->getFixtureLoader($this->getContainer(), $classNames); |
329
|
|
|
|
330
|
|
|
// Use loader in order to fetch all the dependencies fixtures. |
331
|
7 |
|
foreach ($loader->getFixtures() as $className) { |
332
|
3 |
|
$fixtureLastModifiedDateTime = $this->getFixtureLastModified($className); |
333
|
3 |
|
if ($backupLastModifiedDateTime < $fixtureLastModifiedDateTime) { |
334
|
1 |
|
return false; |
335
|
|
|
} |
336
|
7 |
|
} |
337
|
|
|
|
338
|
7 |
|
return true; |
339
|
|
|
} |
340
|
|
|
|
341
|
|
|
/** |
342
|
|
|
* Set the database to the provided fixtures. |
343
|
|
|
* |
344
|
|
|
* Drops the current database and then loads fixtures using the specified |
345
|
|
|
* classes. The parameter is a list of fully qualified class names of |
346
|
|
|
* classes that implement Doctrine\Common\DataFixtures\FixtureInterface |
347
|
|
|
* so that they can be loaded by the DataFixtures Loader::addFixture |
348
|
|
|
* |
349
|
|
|
* When using SQLite this method will automatically make a copy of the |
350
|
|
|
* loaded schema and fixtures which will be restored automatically in |
351
|
|
|
* case the same fixture classes are to be loaded again. Caveat: changes |
352
|
|
|
* to references and/or identities may go undetected. |
353
|
|
|
* |
354
|
|
|
* Depends on the doctrine data-fixtures library being available in the |
355
|
|
|
* class path. |
356
|
|
|
* |
357
|
|
|
* @param array $classNames List of fully qualified class names of fixtures to load |
358
|
|
|
* @param string $omName The name of object manager to use |
359
|
|
|
* @param string $registryName The service id of manager registry to use |
360
|
|
|
* @param int $purgeMode Sets the ORM purge mode |
361
|
|
|
* |
362
|
|
|
* @return null|AbstractExecutor |
363
|
|
|
*/ |
364
|
36 |
|
protected function loadFixtures(array $classNames, $omName = null, $registryName = 'doctrine', $purgeMode = null) |
365
|
|
|
{ |
366
|
36 |
|
$container = $this->getContainer(); |
367
|
|
|
/** @var ManagerRegistry $registry */ |
368
|
36 |
|
$registry = $container->get($registryName); |
369
|
|
|
/** @var ObjectManager $om */ |
370
|
36 |
|
$om = $registry->getManager($omName); |
371
|
36 |
|
$type = $registry->getName(); |
372
|
|
|
|
373
|
36 |
|
$executorClass = 'PHPCR' === $type && class_exists('Doctrine\Bundle\PHPCRBundle\DataFixtures\PHPCRExecutor') |
374
|
36 |
|
? 'Doctrine\Bundle\PHPCRBundle\DataFixtures\PHPCRExecutor' |
375
|
36 |
|
: 'Doctrine\\Common\\DataFixtures\\Executor\\'.$type.'Executor'; |
376
|
36 |
|
$referenceRepository = new ProxyReferenceRepository($om); |
377
|
36 |
|
$cacheDriver = $om->getMetadataFactory()->getCacheDriver(); |
378
|
|
|
|
379
|
36 |
|
if ($cacheDriver) { |
380
|
36 |
|
$cacheDriver->deleteAll(); |
381
|
36 |
|
} |
382
|
|
|
|
383
|
36 |
|
if ('ORM' === $type) { |
384
|
35 |
|
$connection = $om->getConnection(); |
385
|
35 |
|
if ($connection->getDriver() instanceof SqliteDriver) { |
386
|
30 |
|
$params = $connection->getParams(); |
387
|
30 |
|
if (isset($params['master'])) { |
388
|
|
|
$params = $params['master']; |
389
|
|
|
} |
390
|
|
|
|
391
|
30 |
|
$name = isset($params['path']) ? $params['path'] : (isset($params['dbname']) ? $params['dbname'] : false); |
392
|
30 |
|
if (!$name) { |
393
|
|
|
throw new \InvalidArgumentException("Connection does not contain a 'path' or 'dbname' parameter and cannot be dropped."); |
394
|
|
|
} |
395
|
|
|
|
396
|
30 |
|
if (!isset(self::$cachedMetadatas[$omName])) { |
397
|
10 |
|
self::$cachedMetadatas[$omName] = $om->getMetadataFactory()->getAllMetadata(); |
398
|
10 |
|
usort(self::$cachedMetadatas[$omName], function ($a, $b) { |
399
|
|
|
return strcmp($a->name, $b->name); |
400
|
10 |
|
}); |
401
|
10 |
|
} |
402
|
30 |
|
$metadatas = self::$cachedMetadatas[$omName]; |
403
|
|
|
|
404
|
30 |
|
if ($container->getParameter('liip_functional_test.cache_sqlite_db')) { |
405
|
9 |
|
$backup = $container->getParameter('kernel.cache_dir').'/test_'.md5(serialize($metadatas).serialize($classNames)).'.db'; |
406
|
9 |
|
if (file_exists($backup) && file_exists($backup.'.ser') && $this->isBackupUpToDate($classNames, $backup)) { |
407
|
7 |
|
$connection = $this->getContainer()->get('doctrine.orm.entity_manager')->getConnection(); |
408
|
7 |
|
if (null !== $connection) { |
409
|
7 |
|
$connection->close(); |
410
|
7 |
|
} |
411
|
|
|
|
412
|
7 |
|
$om->flush(); |
413
|
7 |
|
$om->clear(); |
414
|
|
|
|
415
|
7 |
|
$this->preFixtureBackupRestore($om, $referenceRepository, $backup); |
416
|
|
|
|
417
|
7 |
|
copy($backup, $name); |
418
|
|
|
|
419
|
7 |
|
$executor = new $executorClass($om); |
420
|
7 |
|
$executor->setReferenceRepository($referenceRepository); |
421
|
7 |
|
$executor->getReferenceRepository()->load($backup); |
422
|
|
|
|
423
|
7 |
|
$this->postFixtureBackupRestore($backup); |
424
|
|
|
|
425
|
7 |
|
return $executor; |
426
|
|
|
} |
427
|
3 |
|
} |
428
|
|
|
|
429
|
|
|
// TODO: handle case when using persistent connections. Fail loudly? |
430
|
24 |
|
$schemaTool = new SchemaTool($om); |
|
|
|
|
431
|
24 |
|
$schemaTool->dropDatabase(); |
432
|
24 |
|
if (!empty($metadatas)) { |
433
|
24 |
|
$schemaTool->createSchema($metadatas); |
434
|
24 |
|
} |
435
|
24 |
|
$this->postFixtureSetup(); |
436
|
|
|
|
437
|
24 |
|
$executor = new $executorClass($om); |
438
|
24 |
|
$executor->setReferenceRepository($referenceRepository); |
439
|
24 |
|
} |
440
|
29 |
|
} |
441
|
|
|
|
442
|
30 |
|
if (empty($executor)) { |
443
|
6 |
|
$purgerClass = 'Doctrine\\Common\\DataFixtures\\Purger\\'.$type.'Purger'; |
444
|
6 |
|
if ('PHPCR' === $type) { |
445
|
1 |
|
$purger = new $purgerClass($om); |
446
|
1 |
|
$initManager = $container->has('doctrine_phpcr.initializer_manager') |
447
|
1 |
|
? $container->get('doctrine_phpcr.initializer_manager') |
448
|
1 |
|
: null; |
449
|
|
|
|
450
|
1 |
|
$executor = new $executorClass($om, $purger, $initManager); |
451
|
1 |
|
} else { |
452
|
5 |
|
if ('ORM' === $type) { |
453
|
5 |
|
$purger = new $purgerClass(null, $this->excludedDoctrineTables); |
454
|
5 |
|
} else { |
455
|
|
|
$purger = new $purgerClass(); |
456
|
|
|
} |
457
|
|
|
|
458
|
5 |
|
if (null !== $purgeMode) { |
459
|
2 |
|
$purger->setPurgeMode($purgeMode); |
460
|
2 |
|
} |
461
|
|
|
|
462
|
5 |
|
$executor = new $executorClass($om, $purger); |
463
|
|
|
} |
464
|
|
|
|
465
|
6 |
|
$executor->setReferenceRepository($referenceRepository); |
466
|
6 |
|
$executor->purge(); |
467
|
6 |
|
} |
468
|
|
|
|
469
|
30 |
|
$loader = $this->getFixtureLoader($container, $classNames); |
470
|
|
|
|
471
|
30 |
|
$executor->execute($loader->getFixtures(), true); |
472
|
|
|
|
473
|
30 |
|
if (isset($name) && isset($backup)) { |
474
|
3 |
|
$this->preReferenceSave($om, $executor, $backup); |
475
|
|
|
|
476
|
3 |
|
$executor->getReferenceRepository()->save($backup); |
477
|
3 |
|
copy($name, $backup); |
478
|
|
|
|
479
|
3 |
|
$this->postReferenceSave($om, $executor, $backup); |
480
|
3 |
|
} |
481
|
|
|
|
482
|
30 |
|
return $executor; |
483
|
|
|
} |
484
|
|
|
|
485
|
|
|
/** |
486
|
|
|
* Clean database. |
487
|
|
|
* |
488
|
|
|
* @param ManagerRegistry $registry |
489
|
|
|
* @param EntityManager $om |
490
|
|
|
* @param null $omName |
491
|
|
|
*/ |
492
|
9 |
|
private function cleanDatabase(ManagerRegistry $registry, EntityManager $om, $omName = null) |
493
|
|
|
{ |
494
|
9 |
|
$connection = $om->getConnection(); |
495
|
|
|
|
496
|
9 |
|
$mysql = ($registry->getName() === 'ORM' |
497
|
9 |
|
&& $connection->getDatabasePlatform() instanceof MySqlPlatform); |
498
|
|
|
|
499
|
9 |
|
if ($mysql) { |
500
|
1 |
|
$connection->query('SET FOREIGN_KEY_CHECKS=0'); |
501
|
1 |
|
} |
502
|
|
|
|
503
|
9 |
|
$this->loadFixtures(array(), $omName); |
504
|
|
|
|
505
|
9 |
|
if ($mysql) { |
506
|
1 |
|
$connection->query('SET FOREIGN_KEY_CHECKS=1'); |
507
|
1 |
|
} |
508
|
9 |
|
} |
509
|
|
|
|
510
|
|
|
/** |
511
|
|
|
* Locate fixture files. |
512
|
|
|
* |
513
|
|
|
* @param array $paths |
514
|
|
|
* |
515
|
|
|
* @return array $files |
516
|
|
|
* |
517
|
|
|
* @throws \InvalidArgumentException if a wrong path is given outside a bundle |
518
|
|
|
*/ |
519
|
9 |
|
private function locateResources($paths) |
520
|
|
|
{ |
521
|
9 |
|
$files = array(); |
522
|
|
|
|
523
|
9 |
|
$kernel = $this->getContainer()->get('kernel'); |
524
|
|
|
|
525
|
9 |
|
foreach ($paths as $path) { |
526
|
9 |
|
if ($path[0] !== '@') { |
527
|
3 |
|
if (!file_exists($path)) { |
528
|
1 |
|
throw new \InvalidArgumentException(sprintf('Unable to find file "%s".', $path)); |
529
|
|
|
} |
530
|
2 |
|
$files[] = $path; |
531
|
2 |
|
continue; |
532
|
|
|
} |
533
|
|
|
|
534
|
6 |
|
$files[] = $kernel->locateResource($path); |
535
|
7 |
|
} |
536
|
|
|
|
537
|
7 |
|
return $files; |
538
|
|
|
} |
539
|
|
|
|
540
|
|
|
/** |
541
|
|
|
* @param array $paths Either symfony resource locators (@ BundleName/etc) or actual file paths |
542
|
|
|
* @param bool $append |
543
|
|
|
* @param null $omName |
544
|
|
|
* @param string $registryName |
545
|
|
|
* |
546
|
|
|
* @return array |
547
|
|
|
* |
548
|
|
|
* @throws \BadMethodCallException |
549
|
|
|
*/ |
550
|
9 |
|
public function loadFixtureFiles(array $paths = array(), $append = false, $omName = null, $registryName = 'doctrine') |
551
|
|
|
{ |
552
|
9 |
|
if (!class_exists('Nelmio\Alice\Fixtures')) { |
553
|
|
|
// This class is available during tests, no exception will be thrown. |
554
|
|
|
// @codeCoverageIgnoreStart |
555
|
|
|
throw new \BadMethodCallException('nelmio/alice should be installed to use this method.'); |
556
|
|
|
// @codeCoverageIgnoreEnd |
557
|
|
|
} |
558
|
|
|
|
559
|
|
|
/** @var ContainerInterface $container */ |
560
|
9 |
|
$container = $this->getContainer(); |
561
|
|
|
|
562
|
|
|
/** @var ManagerRegistry $registry */ |
563
|
9 |
|
$registry = $container->get($registryName); |
564
|
|
|
|
565
|
|
|
/** @var EntityManager $om */ |
566
|
9 |
|
$om = $registry->getManager($omName); |
567
|
|
|
|
568
|
9 |
|
if ($append === false) { |
569
|
9 |
|
$this->cleanDatabase($registry, $om, $omName); |
570
|
9 |
|
} |
571
|
|
|
|
572
|
9 |
|
$files = $this->locateResources($paths); |
573
|
|
|
|
574
|
|
|
// Check if the Hautelook AliceBundle is registered and if yes, use it instead of Nelmio Alice |
575
|
7 |
|
$hautelookLoaderServiceName = 'hautelook_alice.fixtures.loader'; |
576
|
7 |
|
if ($container->has($hautelookLoaderServiceName)) { |
577
|
3 |
|
$loaderService = $container->get($hautelookLoaderServiceName); |
578
|
3 |
|
$persisterClass = class_exists('Nelmio\Alice\ORM\Doctrine') ? |
579
|
3 |
|
'Nelmio\Alice\ORM\Doctrine' : |
580
|
3 |
|
'Nelmio\Alice\Persister\Doctrine'; |
581
|
|
|
|
582
|
3 |
|
return $loaderService->load(new $persisterClass($om), $files); |
583
|
|
|
} |
584
|
|
|
|
585
|
4 |
|
return Fixtures::load($files, $om); |
586
|
|
|
} |
587
|
|
|
|
588
|
|
|
/** |
589
|
|
|
* Callback function to be executed after Schema creation. |
590
|
|
|
* Use this to execute acl:init or other things necessary. |
591
|
|
|
*/ |
592
|
24 |
|
protected function postFixtureSetup() |
593
|
|
|
{ |
594
|
24 |
|
} |
595
|
|
|
|
596
|
|
|
/** |
597
|
|
|
* Callback function to be executed after Schema restore. |
598
|
|
|
* |
599
|
|
|
* @return WebTestCase |
600
|
|
|
* |
601
|
|
|
* @deprecated since version 1.8, to be removed in 2.0. Use postFixtureBackupRestore method instead. |
602
|
|
|
*/ |
603
|
7 |
|
protected function postFixtureRestore() |
604
|
|
|
{ |
605
|
7 |
|
} |
606
|
|
|
|
607
|
|
|
/** |
608
|
|
|
* Callback function to be executed before Schema restore. |
609
|
|
|
* |
610
|
|
|
* @param ObjectManager $manager The object manager |
611
|
|
|
* @param ProxyReferenceRepository $referenceRepository The reference repository |
612
|
|
|
* |
613
|
|
|
* @return WebTestCase |
614
|
|
|
* |
615
|
|
|
* @deprecated since version 1.8, to be removed in 2.0. Use preFixtureBackupRestore method instead. |
616
|
|
|
*/ |
617
|
7 |
|
protected function preFixtureRestore(ObjectManager $manager, ProxyReferenceRepository $referenceRepository) |
|
|
|
|
618
|
|
|
{ |
619
|
7 |
|
} |
620
|
|
|
|
621
|
|
|
/** |
622
|
|
|
* Callback function to be executed after Schema restore. |
623
|
|
|
* |
624
|
|
|
* @param string $backupFilePath Path of file used to backup the references of the data fixtures |
625
|
|
|
* |
626
|
|
|
* @return WebTestCase |
627
|
|
|
*/ |
628
|
7 |
|
protected function postFixtureBackupRestore($backupFilePath) |
|
|
|
|
629
|
|
|
{ |
630
|
7 |
|
$this->postFixtureRestore(); |
|
|
|
|
631
|
|
|
|
632
|
7 |
|
return $this; |
633
|
|
|
} |
634
|
|
|
|
635
|
|
|
/** |
636
|
|
|
* Callback function to be executed before Schema restore. |
637
|
|
|
* |
638
|
|
|
* @param ObjectManager $manager The object manager |
639
|
|
|
* @param ProxyReferenceRepository $referenceRepository The reference repository |
640
|
|
|
* @param string $backupFilePath Path of file used to backup the references of the data fixtures |
641
|
|
|
* |
642
|
|
|
* @return WebTestCase |
643
|
|
|
*/ |
644
|
7 |
|
protected function preFixtureBackupRestore( |
645
|
|
|
ObjectManager $manager, |
646
|
|
|
ProxyReferenceRepository $referenceRepository, |
647
|
|
|
$backupFilePath |
|
|
|
|
648
|
|
|
) { |
649
|
7 |
|
$this->preFixtureRestore($manager, $referenceRepository); |
|
|
|
|
650
|
|
|
|
651
|
7 |
|
return $this; |
652
|
|
|
} |
653
|
|
|
|
654
|
|
|
/** |
655
|
|
|
* Callback function to be executed after save of references. |
656
|
|
|
* |
657
|
|
|
* @param ObjectManager $manager The object manager |
658
|
|
|
* @param AbstractExecutor $executor Executor of the data fixtures |
659
|
|
|
* @param string $backupFilePath Path of file used to backup the references of the data fixtures |
660
|
|
|
* |
661
|
|
|
* @return WebTestCase |
662
|
|
|
*/ |
663
|
3 |
|
protected function postReferenceSave(ObjectManager $manager, AbstractExecutor $executor, $backupFilePath) |
|
|
|
|
664
|
|
|
{ |
665
|
3 |
|
} |
666
|
|
|
|
667
|
|
|
/** |
668
|
|
|
* Callback function to be executed before save of references. |
669
|
|
|
* |
670
|
|
|
* @param ObjectManager $manager The object manager |
671
|
|
|
* @param AbstractExecutor $executor Executor of the data fixtures |
672
|
|
|
* @param string $backupFilePath Path of file used to backup the references of the data fixtures |
673
|
|
|
* |
674
|
|
|
* @return WebTestCase |
675
|
|
|
*/ |
676
|
3 |
|
protected function preReferenceSave(ObjectManager $manager, AbstractExecutor $executor, $backupFilePath) |
|
|
|
|
677
|
|
|
{ |
678
|
3 |
|
} |
679
|
|
|
|
680
|
|
|
/** |
681
|
|
|
* Retrieve Doctrine DataFixtures loader. |
682
|
|
|
* |
683
|
|
|
* @param ContainerInterface $container |
684
|
|
|
* @param array $classNames |
685
|
|
|
* |
686
|
|
|
* @return Loader |
687
|
|
|
*/ |
688
|
36 |
|
protected function getFixtureLoader(ContainerInterface $container, array $classNames) |
689
|
|
|
{ |
690
|
36 |
|
$loaderClass = class_exists('Symfony\Bridge\Doctrine\DataFixtures\ContainerAwareLoader') |
691
|
36 |
|
? 'Symfony\Bridge\Doctrine\DataFixtures\ContainerAwareLoader' |
692
|
36 |
|
: (class_exists('Doctrine\Bundle\FixturesBundle\Common\DataFixtures\Loader') |
693
|
|
|
// This class is not available during tests. |
694
|
|
|
// @codeCoverageIgnoreStart |
695
|
|
|
? 'Doctrine\Bundle\FixturesBundle\Common\DataFixtures\Loader' |
696
|
|
|
// @codeCoverageIgnoreEnd |
697
|
36 |
|
: 'Symfony\Bundle\DoctrineFixturesBundle\Common\DataFixtures\Loader'); |
698
|
|
|
|
699
|
36 |
|
$loader = new $loaderClass($container); |
700
|
|
|
|
701
|
36 |
|
foreach ($classNames as $className) { |
702
|
11 |
|
$this->loadFixtureClass($loader, $className); |
703
|
36 |
|
} |
704
|
|
|
|
705
|
36 |
|
return $loader; |
706
|
|
|
} |
707
|
|
|
|
708
|
|
|
/** |
709
|
|
|
* Load a data fixture class. |
710
|
|
|
* |
711
|
|
|
* @param Loader $loader |
712
|
|
|
* @param string $className |
713
|
|
|
*/ |
714
|
11 |
|
protected function loadFixtureClass($loader, $className) |
715
|
|
|
{ |
716
|
11 |
|
$fixture = new $className(); |
717
|
|
|
|
718
|
11 |
|
if ($loader->hasFixture($fixture)) { |
719
|
2 |
|
unset($fixture); |
720
|
|
|
|
721
|
2 |
|
return; |
722
|
|
|
} |
723
|
|
|
|
724
|
11 |
|
$loader->addFixture($fixture); |
725
|
|
|
|
726
|
11 |
|
if ($fixture instanceof DependentFixtureInterface) { |
727
|
2 |
|
foreach ($fixture->getDependencies() as $dependency) { |
728
|
2 |
|
$this->loadFixtureClass($loader, $dependency); |
729
|
2 |
|
} |
730
|
2 |
|
} |
731
|
11 |
|
} |
732
|
|
|
|
733
|
|
|
/** |
734
|
|
|
* Creates an instance of a lightweight Http client. |
735
|
|
|
* |
736
|
|
|
* If $authentication is set to 'true' it will use the content of |
737
|
|
|
* 'liip_functional_test.authentication' to log in. |
738
|
|
|
* |
739
|
|
|
* $params can be used to pass headers to the client, note that they have |
740
|
|
|
* to follow the naming format used in $_SERVER. |
741
|
|
|
* Example: 'HTTP_X_REQUESTED_WITH' instead of 'X-Requested-With' |
742
|
|
|
* |
743
|
|
|
* @param bool|array $authentication |
744
|
|
|
* @param array $params |
745
|
|
|
* |
746
|
|
|
* @return Client |
747
|
|
|
*/ |
748
|
54 |
|
protected function makeClient($authentication = false, array $params = array()) |
749
|
|
|
{ |
750
|
54 |
|
if ($authentication) { |
751
|
2 |
|
if ($authentication === true) { |
752
|
|
|
$authentication = array( |
753
|
1 |
|
'username' => $this->getContainer() |
754
|
1 |
|
->getParameter('liip_functional_test.authentication.username'), |
755
|
1 |
|
'password' => $this->getContainer() |
756
|
1 |
|
->getParameter('liip_functional_test.authentication.password'), |
757
|
1 |
|
); |
758
|
1 |
|
} |
759
|
|
|
|
760
|
2 |
|
$params = array_merge($params, array( |
761
|
2 |
|
'PHP_AUTH_USER' => $authentication['username'], |
762
|
2 |
|
'PHP_AUTH_PW' => $authentication['password'], |
763
|
2 |
|
)); |
764
|
2 |
|
} |
765
|
|
|
|
766
|
54 |
|
$client = static::createClient(array('environment' => $this->environment), $params); |
767
|
|
|
|
768
|
54 |
|
if ($this->firewallLogins) { |
|
|
|
|
769
|
|
|
// has to be set otherwise "hasPreviousSession" in Request returns false. |
770
|
2 |
|
$options = $client->getContainer()->getParameter('session.storage.options'); |
771
|
|
|
|
772
|
2 |
|
if (!$options || !isset($options['name'])) { |
773
|
|
|
throw new \InvalidArgumentException('Missing session.storage.options#name'); |
774
|
|
|
} |
775
|
|
|
|
776
|
2 |
|
$session = $client->getContainer()->get('session'); |
777
|
|
|
// Since the namespace of the session changed in symfony 2.1, instanceof can be used to check the version. |
778
|
2 |
|
if ($session instanceof Session) { |
779
|
2 |
|
$session->setId(uniqid()); |
780
|
2 |
|
} |
781
|
|
|
|
782
|
2 |
|
$client->getCookieJar()->set(new Cookie($options['name'], $session->getId())); |
783
|
|
|
|
784
|
|
|
/** @var $user UserInterface */ |
785
|
2 |
|
foreach ($this->firewallLogins as $firewallName => $user) { |
786
|
2 |
|
$token = $this->createUserToken($user, $firewallName); |
787
|
|
|
|
788
|
|
|
// BC: security.token_storage is available on Symfony 2.6+ |
789
|
|
|
// see http://symfony.com/blog/new-in-symfony-2-6-security-component-improvements |
790
|
2 |
|
if ($client->getContainer()->has('security.token_storage')) { |
791
|
2 |
|
$tokenStorage = $client->getContainer()->get('security.token_storage'); |
792
|
2 |
|
} else { |
793
|
|
|
// This block will never be reached with Symfony 2.6+ |
794
|
|
|
// @codeCoverageIgnoreStart |
795
|
|
|
$tokenStorage = $client->getContainer()->get('security.context'); |
796
|
|
|
// @codeCoverageIgnoreEnd |
797
|
|
|
} |
798
|
|
|
|
799
|
2 |
|
$tokenStorage->setToken($token); |
800
|
2 |
|
$session->set('_security_'.$firewallName, serialize($token)); |
801
|
2 |
|
} |
802
|
|
|
|
803
|
2 |
|
$session->save(); |
804
|
2 |
|
} |
805
|
|
|
|
806
|
54 |
|
return $client; |
807
|
|
|
} |
808
|
|
|
|
809
|
|
|
/** |
810
|
|
|
* Create User Token. |
811
|
|
|
* |
812
|
|
|
* Factory method for creating a User Token object for the firewall based on |
813
|
|
|
* the user object provided. By default it will be a Username/Password |
814
|
|
|
* Token based on the user's credentials, but may be overridden for custom |
815
|
|
|
* tokens in your applications. |
816
|
|
|
* |
817
|
|
|
* @param UserInterface $user The user object to base the token off of |
818
|
|
|
* @param string $firewallName name of the firewall provider to use |
819
|
|
|
* |
820
|
|
|
* @return TokenInterface The token to be used in the security context |
821
|
|
|
*/ |
822
|
2 |
|
protected function createUserToken(UserInterface $user, $firewallName) |
823
|
|
|
{ |
824
|
2 |
|
return new UsernamePasswordToken( |
825
|
2 |
|
$user, |
826
|
2 |
|
null, |
827
|
2 |
|
$firewallName, |
828
|
2 |
|
$user->getRoles() |
829
|
2 |
|
); |
830
|
|
|
} |
831
|
|
|
|
832
|
|
|
/** |
833
|
|
|
* Extracts the location from the given route. |
834
|
|
|
* |
835
|
|
|
* @param string $route The name of the route |
836
|
|
|
* @param array $params Set of parameters |
837
|
|
|
* @param int $absolute |
838
|
|
|
* |
839
|
|
|
* @return string |
840
|
|
|
*/ |
841
|
1 |
|
protected function getUrl($route, $params = array(), $absolute = UrlGeneratorInterface::ABSOLUTE_PATH) |
842
|
|
|
{ |
843
|
1 |
|
return $this->getContainer()->get('router')->generate($route, $params, $absolute); |
844
|
|
|
} |
845
|
|
|
|
846
|
|
|
/** |
847
|
|
|
* Checks the success state of a response. |
848
|
|
|
* |
849
|
|
|
* @param Response $response Response object |
850
|
|
|
* @param bool $success to define whether the response is expected to be successful |
851
|
|
|
* @param string $type |
852
|
|
|
*/ |
853
|
6 |
|
public function isSuccessful(Response $response, $success = true, $type = 'text/html') |
854
|
|
|
{ |
855
|
6 |
|
HttpAssertions::isSuccessful($response, $success, $type); |
856
|
5 |
|
} |
857
|
|
|
|
858
|
|
|
/** |
859
|
|
|
* Executes a request on the given url and returns the response contents. |
860
|
|
|
* |
861
|
|
|
* This method also asserts the request was successful. |
862
|
|
|
* |
863
|
|
|
* @param string $path path of the requested page |
864
|
|
|
* @param string $method The HTTP method to use, defaults to GET |
865
|
|
|
* @param bool $authentication Whether to use authentication, defaults to false |
866
|
|
|
* @param bool $success to define whether the response is expected to be successful |
867
|
|
|
* |
868
|
|
|
* @return string |
869
|
|
|
*/ |
870
|
1 |
|
public function fetchContent($path, $method = 'GET', $authentication = false, $success = true) |
871
|
|
|
{ |
872
|
1 |
|
$client = $this->makeClient($authentication); |
873
|
1 |
|
$client->request($method, $path); |
874
|
|
|
|
875
|
1 |
|
$content = $client->getResponse()->getContent(); |
876
|
1 |
|
if (is_bool($success)) { |
877
|
1 |
|
$this->isSuccessful($client->getResponse(), $success); |
|
|
|
|
878
|
1 |
|
} |
879
|
|
|
|
880
|
1 |
|
return $content; |
881
|
|
|
} |
882
|
|
|
|
883
|
|
|
/** |
884
|
|
|
* Executes a request on the given url and returns a Crawler object. |
885
|
|
|
* |
886
|
|
|
* This method also asserts the request was successful. |
887
|
|
|
* |
888
|
|
|
* @param string $path path of the requested page |
889
|
|
|
* @param string $method The HTTP method to use, defaults to GET |
890
|
|
|
* @param bool $authentication Whether to use authentication, defaults to false |
891
|
|
|
* @param bool $success Whether the response is expected to be successful |
892
|
|
|
* |
893
|
|
|
* @return Crawler |
894
|
|
|
*/ |
895
|
1 |
|
public function fetchCrawler($path, $method = 'GET', $authentication = false, $success = true) |
896
|
|
|
{ |
897
|
1 |
|
$client = $this->makeClient($authentication); |
898
|
1 |
|
$crawler = $client->request($method, $path); |
899
|
|
|
|
900
|
1 |
|
$this->isSuccessful($client->getResponse(), $success); |
|
|
|
|
901
|
|
|
|
902
|
1 |
|
return $crawler; |
903
|
|
|
} |
904
|
|
|
|
905
|
|
|
/** |
906
|
|
|
* @param UserInterface $user |
907
|
|
|
* @param string $firewallName |
908
|
|
|
* |
909
|
|
|
* @return WebTestCase |
910
|
|
|
*/ |
911
|
2 |
|
public function loginAs(UserInterface $user, $firewallName) |
912
|
|
|
{ |
913
|
2 |
|
$this->firewallLogins[$firewallName] = $user; |
914
|
|
|
|
915
|
2 |
|
return $this; |
916
|
|
|
} |
917
|
|
|
|
918
|
|
|
/** |
919
|
|
|
* Asserts that the HTTP response code of the last request performed by |
920
|
|
|
* $client matches the expected code. If not, raises an error with more |
921
|
|
|
* information. |
922
|
|
|
* |
923
|
|
|
* @param $expectedStatusCode |
924
|
|
|
* @param Client $client |
925
|
|
|
*/ |
926
|
12 |
|
public function assertStatusCode($expectedStatusCode, Client $client) |
927
|
|
|
{ |
928
|
12 |
|
HttpAssertions::assertStatusCode($expectedStatusCode, $client); |
929
|
9 |
|
} |
930
|
|
|
|
931
|
|
|
/** |
932
|
|
|
* Assert that the last validation errors within $container match the |
933
|
|
|
* expected keys. |
934
|
|
|
* |
935
|
|
|
* @param array $expected A flat array of field names |
936
|
|
|
* @param ContainerInterface $container |
937
|
|
|
*/ |
938
|
3 |
|
public function assertValidationErrors(array $expected, ContainerInterface $container) |
939
|
|
|
{ |
940
|
3 |
|
HttpAssertions::assertValidationErrors($expected, $container); |
941
|
1 |
|
} |
942
|
|
|
|
943
|
|
|
/** |
944
|
|
|
* @param array $excludedDoctrineTables |
945
|
|
|
*/ |
946
|
1 |
|
public function setExcludedDoctrineTables($excludedDoctrineTables) |
947
|
|
|
{ |
948
|
1 |
|
$this->excludedDoctrineTables = $excludedDoctrineTables; |
949
|
1 |
|
} |
950
|
|
|
} |
951
|
|
|
|
Instead of super-globals, we recommend to explicitly inject the dependencies of your class. This makes your code less dependent on global state and it becomes generally more testable: