Upgrade PHPUnit to 9.5.x

Requirements:

• Ability to edit files.
• Some coverage extension/tool enabled (xdebug, pcov...)

Xdebug installation in Ubuntu/LinuxMint

1. Update your system

   sudo apt update && sudo apt upgrade -y

2. Install Xdebug appropriate to your PHP version. e.g. on PHP 7.3:

   sudo apt install php7.3-xdebug

3. Check that Xdebug is enabled:

   php -v

   You should see something like "with Xdebug v3.0.3, Copyright (c) 2002-2021, by Derick Rethans" at the bottom of the output.

4. Export Xdebug mode environment variable

   export XDEBUG_MODE=coverage

Automated tests (Integrator to confirm this)

1. Ensure that all CI test pass ok (Behat included because this issue comes with a noticeable composer.lock changeset).
2. Also, check that there aren't "W" (warnings about deprecated stuff) in the PHPUnit output.

Manual tests

Coverage-related changes

A - Ensure that you've some coverage extension available.

1. Run vendor/bin/phpunit -v --coverage-html /tmp --filter mod_h5pactivity_generator_testcase
2. Verify that, after running the tests you see "Generating code coverage report in HTML format ... done"
3. Verify that if you open /tmp/index.html in the browser you see a coverage report with 6 directories: admin, grade, h5p, lib, mod, privacy.

B - Check that the deprecation message when old properties are used is working.

1. Edit mod/h5pactivity/tests/coverage.php and change $includelistfolders by $whitelistfolders.
2. Run php admin/tool/phpunit/cli/init.php
3. Verify that you see the message: "Warning: $whitelistfolders and $whitelistfiles in coverage.php files are deprecated since Moodle 3.11. Please, replace them with $includelistfolders and $includelistfiles in mod/h5pactivity/tests/coverage.php"
4. Run vendor/bin/phpunit -v --coverage-html /tmp --filter mod_h5pactivity_generator_testcase
5. Verify that, after running the tests you see "Generating code coverage report in HTML format ... done"
6. Verify that if you open /tmp/index.html in the browser you see a coverage report with 6 directories: admin, grade, h5p, lib, mod, privacy.
7. Verify that if you follow the "lib" element, you don't see neither the "xmldb" dir or the "weblib.php" file.
8. Edit mod/h5pactivity/tests/coverage.php and change back $whitelistfolders to $includelistfolders.

C - check that adding includes add stuff to coverage report.

1. Edit lib/tests/coverage.php and add "xmldb" to the $includelistfolders property and add "weblib.php" to the $includelistfiles property.
2. Run php admin/tool/phpunit/cli/init.php
3. Verify that there aren't warnings.
4. Run vendor/bin/phpunit -v --coverage-html /tmp --filter mod_h5pactivity_generator_testcase
5. Verify that if you open /tmp/index.html in the browser you see a coverage report with 6 directories: admin, grade, h5p, lib, mod, privacy.
6. Verify that if you follow the "lib" element, you see both the "xmldb" dir and the "weblib.php" file (with some coverage %).
7. Verify that if you follow the "xmldb" element, you see 8 files, one of them being "xmldb_constants.php".

D - Check that adding excludes remove stuff from coverage report.

1. Without un-doing the changes peformed in previous test.
2. Edit lib/tests/coverage.php and add "classes/access" to the $excludelistfolders property and add "xmldb/xmldb_constants.php" to the $excludelistfiles property.
3. Run php admin/tool/phpunit/cli/init.php
4. Verify that there aren't warnings.
5. Run vendor/bin/phpunit -v --coverage-html /tmp --filter mod_h5pactivity_generator_testcase
6. Verify that if you open /tmp/index.html in the browser you see a coverage report with 6 directories: admin, grade, h5p, lib, mod, privacy.
7. Verify that if you follow the lib -> classes links... you don't see the "access" directory.
8. Verify that if you follow the lib -> xmldb links... you don't see the "xmldb_constants.php" file (but still see another 7 files).

Execution options related

E - Verify that suite/config/filter options continue working.

1. Run php admin/tool/phpunit/cli/init.php
2. Run php admin/tool/phpunit/cli/util.php --buildcomponentconfigs
3. Run vendor/bin/phpunit --testsuite mod_h5pactivity_testsuite.
4. Verify it works and shows around "270 tests, 2467 assertions" (numbers may change a bit).
5. Run vendor/bin/phpunit -c mod/h5pactivity
6. Verify it works and shows the same numbers than the previous run.
7. Run vendor/bin/phpunit --filter mod_h5pactivity_generator_testcase
8. Verify it works and shows around "17 tests, 191 assertions" (numbers may change a bit).
9. Run vendor/bin/phpunit --filter ::test_create_file_exception
10. Verify it works and shows "1 test, 1 assertion"
11. Run vendor/bin/phpunit --filter mod_h5pactivity_generator_testcase::test_create_file_exception
12. Verify it works and shows "1 test, 1 assertion"