test: add phpunit bootstrap and coverage config

kyau · kyau · commit b758e2e7fabd · 2026-07-06T01:13:29.000-07:00
Add tests/bootstrap.php with error_reporting and display_errors
setup, plus platform-aware coverage driver documentation.

Add bootstrap attribute to phpunit.xml pointing to the new file,
and add a &lt;coverage&gt; section with HTML (tests/coverage/) and text
(tests/coverage.txt) report output targets.

Plan-by: glm-5.2
Acked-by: deepseek-v4-pro
Signed-off-by: kyau &lt;git@kyaulabs.com&gt;
diff --git a/phpunit.xml b/phpunit.xml
@@ -2,6 +2,7 @@
 <phpunit
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:noNamespaceSchemaLocation="vendor/phpunit/phpunit/phpunit.xsd"
+    bootstrap="tests/bootstrap.php"
     cacheDirectory=".phpunit.cache"
     colors="true"
 >
@@ -32,4 +33,11 @@
             <file>.php-cs-fixer.dist.php</file>
         </exclude>
     </source>
+
+    <coverage>
+        <report>
+            <html outputDirectory="tests/coverage"/>
+            <text outputFile="tests/coverage.txt"/>
+        </report>
+    </coverage>
 </phpunit>
diff --git a/tests/bootstrap.php b/tests/bootstrap.php
@@ -0,0 +1,25 @@
+<?php
+
+# $KYAULabs: bootstrap.php kyau@nova 2026/07/04 -0700 Exp $
+
+
+declare(strict_types=1);
+
+// ── Platform-aware coverage driver selection ────────────────────────
+// PHPUnit auto-detects PCOV > Xdebug > phpdbg.
+// PCOV is preferred on Linux/macOS (lower overhead).
+// Xdebug is used on Windows (PCOV Windows DLLs only exist up to PHP 8.3;
+//   this project targets PHP 8.5+, so Xdebug is required on Windows).
+//
+// No manual configuration needed — PHPUnit 11+ handles this.
+// Just ensure EITHER extension is loaded:
+//   Linux/macOS:  sudo pecl install pcov
+//   Windows:      install matching php_xdebug.dll from xdebug.org/download
+
+error_reporting(E_ALL);
+ini_set('display_errors', '0');
+
+//require_once __DIR__ . '/../aurora.inc.php';
+// vim: ft=php sts=4 sw=4 ts=4 et :
+
+// vim: ft=php sts=4 sw=4 ts=4 et :
