Changeset 60674

Timestamp:

08/26/2025 09:52:58 PM (3 months ago)

Author:

jorbin

Message:

Build/Test Tools: Update in-repo PHPUnit documentation to point to a single source of truth.

Props q0rban, ironprogrammer, desrosj, peterwilsoncc, juampick.
Fixes #62065.

File:

• trunk/tests/phpunit/README.md (moved) (moved from trunk/tests/phpunit/README.txt) (1 diff)

trunk/tests/phpunit/README.md

@@ -1 @@
-The short version:
+# PHPUnit Tests
 
-1. Create a clean MySQL database and user. DO NOT USE AN EXISTING DATABASE or you will lose data, guaranteed.
+PHPUnit is the official testing framework chosen by the core team to test PHP code.
 
-2. Copy wp-tests-config-sample.php to wp-tests-config.php, edit it and include your database name/user/password.
-
-3. $ svn up
-
-4. Run the tests from the "trunk" directory:
-   To execute a particular test:
-      $ phpunit tests/phpunit/tests/test_case.php
-   To execute all tests:
-      $ phpunit
-
-Notes:
-
-Test cases live in the 'tests' subdirectory. All files in that directory will be included by default. Extend the WP_UnitTestCase class to ensure your test is run.
-
-phpunit will initialize and install a (more or less) complete running copy of WordPress each time it is run. This makes it possible to run functional interface and module tests against a fully working database and codebase, as opposed to pure unit tests with mock objects and stubs. Pure unit tests may be used also, of course.
-
-Changes to the test database will be rolled back as tests are finished, to ensure a clean start next time the tests are run.
-
-phpunit is intended to run at the command line, not via a web server.
+For more information, please review the relevant Core Handbook pages:
+- [PHP: PHPUnit](https://make.wordpress.org/core/handbook/testing/automated-testing/phpunit/)
+- [Writing PHP Tests](https://make.wordpress.org/core/handbook/testing/automated-testing/writing-phpunit-tests/)