Software Testing

Due to the nature of this project, it is essential to ensure that the logic is properly tested.

For example, it is important to test whether the API calls to the supported Registrars are correctly implemented.

Run the tests

Before proceeding, note that the first command drops the test database if it exists to ensure a clean testing environment.

php bin/console doctrine:database:drop --env=test --force

Configure the test environment

1. Create a test database

   php bin/console doctrine:database:create --env=test

   This command will create a blank database, suffixed with _test so as not to interfere with your development database.

2. Run the database migrations

   php bin/console doctrine:migrations:migrate --env=test

3. Configure the specific environment variables for the tests

   cp .env.test .env.test.local

   This file is ignored by version control and lets you configure credentials or secrets required for certain integration tests.

Run the tests with PHPUnit

This project uses the PHPUnit framework for writing and running tests. It is a good idea to read the Symfony documentation specific to testing before starting.

To run the tests, execute the following command and observe the results.

php vendor/bin/phpunit

Tip

Depending on the integrated development environment (IDE) you use, it may have PHPUnit integration. This integration can be very useful for viewing code coverage and helping you interpret test results.

If you choose to run the tests using the command line, you can expect to get a result similar to the one below.

PHPUnit 10.5.58 by Sebastian Bergmann and contributors.

Runtime:       PHP 8.4.15
Configuration: /home/maelgangloff/Documents/git/domain-watchdog/phpunit.dist.xml

DDDDDDDDDDDDDDDDD.DDDDDD.............DDDDDDDDSDDDDDDDDD           55 / 55 (100%)

Faker seed: 777840

Time: 00:30.381, Memory: 318.50 MB

OK, but there were issues!
Tests: 55, Assertions: 86, Deprecations: 26, Skipped: 1.

In this example, note that a test has been skipped (the highlighted S in the result above). This test verifies the purchase of a domain name using a Registrar’s sandbox API. Because authentication credentials are not set in the environment variables, this test is configured to be skipped.

To configure these variables, please modify the file specific to the test environment.

• Répertoiredomain-watchdog

  • .env.test
  • .env.test.local
  • …

Write new tests

All tests should be placed under tests/ and follow PHPUnit’s naming conventions (*Test.php).

Note

Ideally, every proposed code change (via Pull Requests) MUST include tests covering the related modifications. Refer to the Contributing section for more details on the guidelines.

Create a Pull Request Instructions for submitting pull requests

This requirement is especially important for any change affecting the project’s logic or algorithms.

If you are not yet familiar with writing tests, you are still welcome to submit your changes. Other contributors can help ensure the necessary tests are added.

Writing tests for a new Provider

The procedure for creating tests for a new provider is described on the dedicated page below.

Testing a new Provider Follow these steps to test your implementation of a new Provider