phpunit: Deprecate tests/phpunit/phpunit.php script

`composer phpunit:entrypoint` should be used instead. Copy all the
setup to a new bootstrap file, with some adjustments for the bootstrap
not being in the global scope when PHPUnit loads it.

Leave the old script and bootstrap in place (e.g., for CI), but make
them print deprecation warnings.

Update the composer scripts to use the standard `phpunit` entrypoint.

The bootstrap code was copied almost verbatim from the phpunit.php
entrypoint to minimize changes. Any improvements can be done in other
patches.

Bug: T90875
Change-Id: I95a80c44f8d88c3c498efe1ae64008f0ff1eea55

1 files changed, 11 insertions, 0 deletions

diff --git a/tests/phpunit/phpunit.php b/tests/phpunit/phpunit.php
index e26c280a16f2..52f27e825479 100644
--- a/tests/phpunit/phpunit.php
+++ b/tests/phpunit/phpunit.php
@@ -98,10 +98,21 @@ class PHPUnitMaintClass {
 			// or when T227900 is resolved.
 			$args[] = '--configuration=' . __DIR__ . '/suite.xml';
 		}
+		$args[] = '--bootstrap=' . __DIR__ . '/bootstrap.maintenance.php';
 		$command->run( $args, true );
 	}
 }
 
+$deprecationMsg = <<<EOT
+*******************************************************************************
+DEPRECATED: The tests/phpunit/phpunit.php entry point has been deprecated. Use
+            `composer phpunit:entrypoint` instead.
+*******************************************************************************
+
+EOT;
+
+fwrite( STDERR, $deprecationMsg );
+
 if ( defined( 'MEDIAWIKI' ) ) {
 	exit( 'Wrong entry point?' );
 }