Тестування
Оскільки ми починаємо додавати все більше і більше функціональності в застосунок, напевно, саме час поговорити про тестування.
Цікавий факт: я знайшов помилку під час написання тестів у цьому розділі.
Symfony використовує PHPUnit для модульного тестування. Встановімо його:
1
$ symfony composer req phpunit --dev
Написання модульних тестів
SpamChecker — це перший клас, для якого ми будемо писати тести. Згенеруйте модульний тест:
1
$ symfony console make:test TestCase SpamCheckerTest
Тестування SpamChecker є складним завданням, оскільки ми, звичайно, не хочемо викликати API Akismet. Ми збираємося імітувати API.
Напишімо перший тест на той випадок, коли API повертає помилку:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31
--- a/tests/SpamCheckerTest.php
+++ b/tests/SpamCheckerTest.php
@@ -2,12 +2,26 @@
namespace App\Tests;
+use App\Entity\Comment;
+use App\SpamChecker;
use PHPUnit\Framework\TestCase;
+use Symfony\Component\HttpClient\MockHttpClient;
+use Symfony\Component\HttpClient\Response\MockResponse;
+use Symfony\Contracts\HttpClient\ResponseInterface;
class SpamCheckerTest extends TestCase
{
- public function testSomething(): void
+ public function testSpamScoreWithInvalidRequest(): void
{
- $this->assertTrue(true);
+ $comment = new Comment();
+ $comment->setCreatedAtValue();
+ $context = [];
+
+ $client = new MockHttpClient([new MockResponse('invalid', ['response_headers' => ['x-akismet-debug-help: Invalid key']])]);
+ $checker = new SpamChecker($client, 'abcde');
+
+ $this->expectException(\RuntimeException::class);
+ $this->expectExceptionMessage('Unable to check for spam: invalid (Invalid key).');
+ $checker->getSpamScore($comment, $context);
}
}
Клас MockHttpClient
дозволяє імітувати будь-який HTTP-сервер. Він приймає масив екземплярів MockResponse
, що містять очікуване тіло і заголовки відповіді.
Потім ми викликаємо метод getSpamScore()
і перевіряємо чи було кинуто виняток, за допомогою методу PHPUnit expectException()
.
Виконайте тести, щоб перевірити, що вони проходять:
1
$ symfony php bin/phpunit
Додаймо тести для успішного сценарію:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35
--- a/tests/SpamCheckerTest.php
+++ b/tests/SpamCheckerTest.php
@@ -24,4 +24,32 @@ class SpamCheckerTest extends TestCase
$this->expectExceptionMessage('Unable to check for spam: invalid (Invalid key).');
$checker->getSpamScore($comment, $context);
}
+
+ /**
+ * @dataProvider getComments
+ */
+ public function testSpamScore(int $expectedScore, ResponseInterface $response, Comment $comment, array $context)
+ {
+ $client = new MockHttpClient([$response]);
+ $checker = new SpamChecker($client, 'abcde');
+
+ $score = $checker->getSpamScore($comment, $context);
+ $this->assertSame($expectedScore, $score);
+ }
+
+ public function getComments(): iterable
+ {
+ $comment = new Comment();
+ $comment->setCreatedAtValue();
+ $context = [];
+
+ $response = new MockResponse('', ['response_headers' => ['x-akismet-pro-tip: discard']]);
+ yield 'blatant_spam' => [2, $response, $comment, $context];
+
+ $response = new MockResponse('true');
+ yield 'spam' => [1, $response, $comment, $context];
+
+ $response = new MockResponse('false');
+ yield 'ham' => [0, $response, $comment, $context];
+ }
}
Постачальники даних PHPUnit дозволяють повторно використовувати ту саму логіку тестування для кількох тестових випадків.
Написання функціональних тестів для контролерів
Тестування контролерів трохи відрізняється від тестування "звичайного" PHP-класу, оскільки ми хочемо виконати тести у контексті HTTP-запиту.
Створіть функціональний тест для контролера конференції:
Використання Symfony
замість PHPUnit\Framework\TestCase
в якості базового класу для наших тестів дає нам гарну абстракцію для функціональних тестів.
Змінна $client
імітує браузер. Однак, замість того щоб робити HTTP-запит до сервера, вона працює із застосунком Symfony безпосередньо. Ця стратегія має кілька переваг: вона набагато швидша, ніж процес взаємодії між клієнтом і сервером, але крім цього вона також дозволяє тестам інтроспектувати стан сервісів після кожного HTTP-запиту.
Цей перший тест перевіряє, чи повертає головна сторінка HTTP-відповідь 200.
Твердження, такі як assertResponseIsSuccessful
, додані поверх PHPUnit, щоб полегшити вашу роботу. Існує багато таких тверджень, визначених Symfony.
Tip
Ми використовували шлях /
для URL-адреси замість того, щоб генерувати його через роутер. Це робиться спеціально, оскільки тестування URL-адрес кінцевих користувачів є частиною того, що ми хочемо протестувати. Якщо ви зміните шлях маршруту — тести зламаються, як приємне нагадування про те, що ви, ймовірно, маєте переспрямувати стару URL-адресу на нову, щоб забезпечити взаємодію з пошуковими системами й веб-сайтами, які посилаються на ваш веб-сайт.
Налаштування тестового середовища
За замовчуванням тести PHPUnit виконуються у середовищі Symfony test
, як визначено в конфігураційному файлі PHPUnit:
Щоб змусити тести працювати, ми маємо встановити секретний рядок AKISMET_KEY
для цього test
середовища:
1
$ symfony console secrets:set AKISMET_KEY --env=test
Робота з тестовою базою даних
Як ми вже бачили, Symfony CLI автоматично надає змінну середовища DATABASE_URL
. Коли APP_ENV
має значення test
, як це встановлено під час запуску PHPUnit, це змінює ім'я бази даних з main
на main_test
, щоб тести мали свою власну базу даних. Це дуже важливо, оскільки нам потрібні стабільні дані для виконання наших тестів, і ми, звичайно, не хочемо перевизначати те, що ми зберігаємо в базі даних середовища розробки.
Перш ніж виконати тест, нам потрібно "ініціалізувати" test
базу даних (створити базу даних і виконати її міграцію):
1 2
$ symfony console doctrine:database:create --env=test
$ symfony console doctrine:migrations:migrate -n --env=test
On Linux and similiar OSes, you can use
APP_ENV=prod
instead of--env=prod
:1
$ APP_ENV=prod symfony console doctrine:database:create
Якщо ви зараз виконаєте тести, PHPUnit більше не буде взаємодіяти з вашою продакшн базою даних. Щоб виконати тільки нові тести, передайте шлях до їх класу:
1
$ symfony php bin/phpunit tests/Controller/ConferenceControllerTest.php
Tip
Якщо тест не проходить, може бути корисним проаналізувати об’єкт Response. Отримайте до нього доступ за допомогою $client->getResponse()
та виведіть використовуючи echo
, щоб побачити, що він собою представляє.
Визначення фікстур
Щоб мати змогу тестувати список коментарів, пагінацію та відправку форми, нам необхідно заповнити базу даних деякими даними. Ми хочемо, щоб дані були однаковими між виконанням тестів, щоб тести проходили успішно. Фікстури — це саме те, що нам потрібно.
Встановіть бандл Doctrine Fixtures:
1
$ symfony composer req orm-fixtures --dev
Під час встановлення було створено новий каталог src/DataFixtures/
зі зразком класу, готовим до налаштування. Поки що додайте дві конференції та один коментар:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38
--- a/src/DataFixtures/AppFixtures.php
+++ b/src/DataFixtures/AppFixtures.php
@@ -2,6 +2,8 @@
namespace App\DataFixtures;
+use App\Entity\Comment;
+use App\Entity\Conference;
use Doctrine\Bundle\FixturesBundle\Fixture;
use Doctrine\Persistence\ObjectManager;
@@ -9,8 +11,24 @@ class AppFixtures extends Fixture
{
public function load(ObjectManager $manager): void
{
- // $product = new Product();
- // $manager->persist($product);
+ $amsterdam = new Conference();
+ $amsterdam->setCity('Amsterdam');
+ $amsterdam->setYear('2019');
+ $amsterdam->setIsInternational(true);
+ $manager->persist($amsterdam);
+
+ $paris = new Conference();
+ $paris->setCity('Paris');
+ $paris->setYear('2020');
+ $paris->setIsInternational(false);
+ $manager->persist($paris);
+
+ $comment1 = new Comment();
+ $comment1->setConference($amsterdam);
+ $comment1->setAuthor('Fabien');
+ $comment1->setEmail('fabien@example.com');
+ $comment1->setText('This was a great conference.');
+ $manager->persist($comment1);
$manager->flush();
}
Коли ми завантажимо фікстури, всі дані будуть видалені; включаючи користувача адміністратора. Щоб уникнути цього, додаймо користувача адміністратора до фікстур:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38
--- a/src/DataFixtures/AppFixtures.php
+++ b/src/DataFixtures/AppFixtures.php
@@ -2,13 +2,22 @@
namespace App\DataFixtures;
+use App\Entity\Admin;
use App\Entity\Comment;
use App\Entity\Conference;
use Doctrine\Bundle\FixturesBundle\Fixture;
use Doctrine\Persistence\ObjectManager;
+use Symfony\Component\PasswordHasher\Hasher\PasswordHasherFactoryInterface;
class AppFixtures extends Fixture
{
+ private $passwordHasherFactory;
+
+ public function __construct(PasswordHasherFactoryInterface $encoderFactory)
+ {
+ $this->passwordHasherFactory = $encoderFactory;
+ }
+
public function load(ObjectManager $manager): void
{
$amsterdam = new Conference();
@@ -30,6 +39,12 @@ class AppFixtures extends Fixture
$comment1->setText('This was a great conference.');
$manager->persist($comment1);
+ $admin = new Admin();
+ $admin->setRoles(['ROLE_ADMIN']);
+ $admin->setUsername('admin');
+ $admin->setPassword($this->passwordHasherFactory->getPasswordHasher(Admin::class)->hash('admin', null));
+ $manager->persist($admin);
+
$manager->flush();
}
}
Tip
Якщо ви не пам'ятаєте, який сервіс потрібно використовувати для даного завдання, використовуйте debug:autowiring
з певним ключовим словом:
1
$ symfony console debug:autowiring encoder
Завантаження фікстур
Завантажте фікстури для середовища/бази даних test
:
1
$ symfony console doctrine:fixtures:load --env=test
Сканування веб-сайту у функціональних тестах
Як ми вже бачили, HTTP-клієнт, який використовується у тестах, імітує браузер, тому ми можемо переміщатися по веб-сайту так, ніби ми використовуємо браузер без графічного інтерфейсу.
Додайте новий тест, який натискає на сторінку конференції з головної сторінки:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22
--- a/tests/Controller/ConferenceControllerTest.php
+++ b/tests/Controller/ConferenceControllerTest.php
@@ -14,4 +14,19 @@ class ConferenceControllerTest extends WebTestCase
$this->assertResponseIsSuccessful();
$this->assertSelectorTextContains('h2', 'Give your feedback');
}
+
+ public function testConferencePage()
+ {
+ $client = static::createClient();
+ $crawler = $client->request('GET', '/');
+
+ $this->assertCount(2, $crawler->filter('h4'));
+
+ $client->clickLink('View');
+
+ $this->assertPageTitleContains('Amsterdam');
+ $this->assertResponseIsSuccessful();
+ $this->assertSelectorTextContains('h2', 'Amsterdam 2019');
+ $this->assertSelectorExists('div:contains("There are 1 comments")');
+ }
}
Опишімо, що відбувається в цьому тесті простою українською мовою:
- Як і в першому тесті, ми переходимо на головну сторінку;
- Метод
request()
повертає екземплярCrawler
, який допомагає знайти елементи на сторінці (як-от посилання, форми чи все, що ви можете отримати за допомогою CSS селекторів або XPath); - Завдяки селектору CSS ми стверджуємо, що в нас є дві конференції, перелічені на головній сторінці;
- Потім ми натискаємо на посилання "View" (оскільки неможливо натиснути більш ніж на одне посилання одночасно, Symfony автоматично вибирає перше знайдене);
- Ми перевіряємо назву сторінки, відповідь та заголовок
<h2>
, щоб впевнитися, що ми знаходимося на потрібній сторінці (ми також могли б перевірити чи збігається запитуваний маршрут); - Нарешті, ми стверджуємо, що на сторінці є 1 коментар.
div:contains()
не є валідним селектором CSS, але Symfony має кілька приємних доповнень, запозичених у jQuery.
Замість того щоб натискати на текст (тобто View
), ми могли б вибрати посилання за допомогою селектора CSS:
1
$client->click($crawler->filter('h4 + p a')->link());
Перевірте, що новий тест проходить успішно:
1
$ symfony php bin/phpunit tests/Controller/ConferenceControllerTest.php
Відправка форми у функціональному тесті
Ви хочете вийти на наступний рівень? Спробуйте додати новий коментар до фотографії на сторінці конференції з тесту, імітуючи відправку форми. Це здається амбітним, чи не так? Подивіться на код, який нам потрібен: він не складніший за той, що ми вже писали:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22
--- a/tests/Controller/ConferenceControllerTest.php
+++ b/tests/Controller/ConferenceControllerTest.php
@@ -29,4 +29,19 @@ class ConferenceControllerTest extends WebTestCase
$this->assertSelectorTextContains('h2', 'Amsterdam 2019');
$this->assertSelectorExists('div:contains("There are 1 comments")');
}
+
+ public function testCommentSubmission()
+ {
+ $client = static::createClient();
+ $client->request('GET', '/conference/amsterdam-2019');
+ $client->submitForm('Submit', [
+ 'comment_form[author]' => 'Fabien',
+ 'comment_form[text]' => 'Some feedback from an automated functional test',
+ 'comment_form[email]' => 'me@automat.ed',
+ 'comment_form[photo]' => dirname(__DIR__, 2).'/public/images/under-construction.gif',
+ ]);
+ $this->assertResponseRedirects();
+ $client->followRedirect();
+ $this->assertSelectorExists('div:contains("There are 2 comments")');
+ }
}
Щоб відправити форму за допомогою submitForm()
, знайдіть імена елементів за допомогою інструментів розробника у веб-браузері або вкладки Form на панелі Symfony Profiler. Зверніть увагу на те, як продумано повторно використовується зображення, яке вказує на те, що сайт знаходиться у розробці!
Виконайте тести ще раз, щоб перевірити, чи все проходить успішно:
1
$ symfony php bin/phpunit tests/Controller/ConferenceControllerTest.php
Якщо ви хочете перевірити результат у браузері, зупиніть веб-сервер і повторно запустіть його для середовища test
:
1 2
$ symfony server:stop
$ symfony server:start -d --env=test
Перезавантаження фікстур
Якщо ви виконуєте тести вдруге, вони не пройдуть успішно. Оскільки в базі даних тепер більше коментарів, твердження, що перевіряє їх кількість, порушено. Нам потрібно скидати стан бази даних між кожним виконанням, шляхом перезавантаження фікстур:
1 2
$ symfony console doctrine:fixtures:load --env=test
$ symfony php bin/phpunit tests/Controller/ConferenceControllerTest.php
Автоматизація робочого процесу за допомогою Makefile
Необхідність запам'ятовувати послідовність команд для виконання тестів дратує. Це, принаймні, має бути задокументовано. Але документація — це крайній випадок. Натомість, як щодо автоматизації однотипних завдань? Це послужило б у якості документації, допомогло б іншим розробникам досліджувати проект та полегшити й прискорити розробку.
Використання Makefile
є одним зі способів автоматизації команд:
Warning
У правилі Makefile відступ має складатися з одного символу табуляції замість пробілів.
Зверніть увагу на прапорець -n
у команді Doctrine; це глобальний прапорець команд Symfony, що робить їх неінтерактивними.
Щоразу, коли ви хочете виконати тести, використовуйте make tests
:
1
$ make tests
Скидання бази даних після кожного тесту
Скидання бази даних після кожного виконання тестів, звісно, чудово, але мати справді незалежні тести — ще краще. Ми не хочемо, щоб один тест спирався на результати попередніх. Зміна порядку проведення тестів не має призводити до зміни результату. Як ми зараз з'ясуємо, на даний момент це не так.
Помістіть тест testConferencePage
після testCommentSubmission
:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44
--- a/tests/Controller/ConferenceControllerTest.php
+++ b/tests/Controller/ConferenceControllerTest.php
@@ -15,21 +15,6 @@ class ConferenceControllerTest extends WebTestCase
$this->assertSelectorTextContains('h2', 'Give your feedback');
}
- public function testConferencePage()
- {
- $client = static::createClient();
- $crawler = $client->request('GET', '/');
-
- $this->assertCount(2, $crawler->filter('h4'));
-
- $client->clickLink('View');
-
- $this->assertPageTitleContains('Amsterdam');
- $this->assertResponseIsSuccessful();
- $this->assertSelectorTextContains('h2', 'Amsterdam 2019');
- $this->assertSelectorExists('div:contains("There are 1 comments")');
- }
-
public function testCommentSubmission()
{
$client = static::createClient();
@@ -44,4 +29,19 @@ class ConferenceControllerTest extends WebTestCase
$client->followRedirect();
$this->assertSelectorExists('div:contains("There are 2 comments")');
}
+
+ public function testConferencePage()
+ {
+ $client = static::createClient();
+ $crawler = $client->request('GET', '/');
+
+ $this->assertCount(2, $crawler->filter('h4'));
+
+ $client->clickLink('View');
+
+ $this->assertPageTitleContains('Amsterdam');
+ $this->assertResponseIsSuccessful();
+ $this->assertSelectorTextContains('h2', 'Amsterdam 2019');
+ $this->assertSelectorExists('div:contains("There are 1 comments")');
+ }
}
Тепер тести не проходять успішно.
Щоб скидати базу даних між тестами, встановіть DoctrineTestBundle:
1
$ symfony composer config extra.symfony.allow-contrib true
1
$ symfony composer req "dama/doctrine-test-bundle:^6" --dev
Вам потрібно буде підтвердити виконання рецепту (тому, що він не є "офіційно" підтримуваним бандлом):
1 2 3 4 5 6 7 8 9 10 11
Symfony operations: 1 recipe (a5c79a9ff21bc3ae26d9bb25f1262ed7)
- WARNING dama/doctrine-test-bundle (>=4.0): From github.com/symfony/recipes-contrib:master
The recipe for this package comes from the "contrib" repository, which is open to community contributions.
Review the recipe at https://github.com/symfony/recipes-contrib/tree/master/dama/doctrine-test-bundle/4.0
Do you want to execute this recipe?
[y] Yes
[n] No
[a] Yes for all packages, only for the current installation session
[p] Yes permanently, never ask again for this project
(defaults to n): p
Увімкніть слухача PHPUnit:
1 2 3 4 5 6 7 8 9 10 11 12 13
--- a/phpunit.xml.dist
+++ b/phpunit.xml.dist
@@ -29,6 +29,10 @@
</include>
</coverage>
+ <extensions>
+ <extension class="DAMA\DoctrineTestBundle\PHPUnit\PHPUnitExtension" />
+ </extensions>
+
<listeners>
<listener class="Symfony\Bridge\PhpUnit\SymfonyTestsListener" />
</listeners>
Готово. Будь-які зміни, внесені в тести, тепер автоматично скасовуються в кінці кожного тесту.
Тести знову мають проходити успішно:
1
$ make tests
Використання справжнього веб-браузера для функціональних тестів
Функціональні тести використовують спеціальний браузер, який працює безпосередньо з Symfony. Але ви також можете використовувати реальний веб-браузер і HTTP, завдяки Symfony Panther:
1
$ symfony composer req panther --dev
Потім ви можете написати тести, які використовують реальний браузер Google Chrome з наступними змінами:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19
--- a/tests/Controller/ConferenceControllerTest.php
+++ b/tests/Controller/ConferenceControllerTest.php
@@ -2,13 +2,13 @@
namespace App\Tests\Controller;
-use Symfony\Bundle\FrameworkBundle\Test\WebTestCase;
+use Symfony\Component\Panther\PantherTestCase;
-class ConferenceControllerTest extends WebTestCase
+class ConferenceControllerTest extends PantherTestCase
{
public function testIndex()
{
- $client = static::createClient();
+ $client = static::createPantherClient(['external_base_uri' => $_SERVER['SYMFONY_PROJECT_DEFAULT_ROUTE_URL']]);
$client->request('GET', '/');
$this->assertResponseIsSuccessful();
Змінна середовища SYMFONY_PROJECT_DEFAULT_ROUTE_URL
містить URL-адресу локального веб-сервера.
Вибір правильного типу тесту
Наразі ми створили три різні типи тестів. Хоча ми використовували бандл Maker лише для створення класу модульного тесту, ми могли б використовувати його і для створення класів інших тестів:
1 2 3
$ symfony console make:test WebTestCase Controller\\ConferenceController
$ symfony console make:test PantherTestCase Controller\\ConferenceController
Бандл Maker підтримує генерування наступних типів тестів залежно від того, як ви хочете протестувати свій застосунок:
TestCase
: базові тести PHPUnit;KernelTestCase
: базові тести, які мають доступ до сервісів Symfony;WebTestCase
: для виконання сценаріїв, подібних браузеру, але не виконуючих код JavaScript;ApiTestCase
: для виконання сценаріїв, орієнтованих на API;- "PantherTestCase`: для виконання сценаріїв e2e з використанням реального браузера чи HTTP-клієнта і реального веб-сервера.
Виконання функціональних тестів методом чорної скриньки за допомогою Blackfire
Іншим способом виконання функціональних тестів є використання Blackfire player. Крім функціонального тестування, цей інструмент також може проводити тестування продуктивності.
Перегляньте крок про Продуктивність, щоб дізнатися більше.
Йдемо далі
- Список тверджень, визначених Symfony для функціональних тестів;
- Документація по PHPUnit;
- Бібліотека Faker для генерування реалістичних даних фікстур;
- Документація по компоненту CssSelector;
- Symfony Panther бібліотека для тестування у браузері та веб-сканування у застосунках Symfony;
- Документація по Make/Makefile.