Closes #5951

ChangeLog-11.4.md

@@ -16,4 +16,8 @@ All notable changes of the PHPUnit 11.4 release series are documented in this fi
 * The output of `--list-groups` now shows how many tests a group contains
 * The output of `--list-suites` now shows how many tests a test suite contains
 
+### Deprecated
+
+* [#5951](https://github.com/sebastianbergmann/phpunit/issues/5951): `includeUncoveredFiles` configuration option
+
 [11.4.0]: https://github.com/sebastianbergmann/phpunit/compare/11.3...main

DEPRECATIONS.md

@@ -58,3 +58,4 @@ This functionality is currently [hard-deprecated](https://phpunit.de/backward-co
 | [#5214](https://github.com/sebastianbergmann/phpunit/issues/5214) | `TestCase::iniSet()`                                      | 10.3.0 |                                     |
 | [#5216](https://github.com/sebastianbergmann/phpunit/issues/5216) | `TestCase::setLocale()`                                   | 10.3.0 |                                     |
 | [#5800](https://github.com/sebastianbergmann/phpunit/issues/5800) | Targeting traits with `#[CoversClass]` and `#[UsesClass]` | 11.2.0 | `#[CoversClass]` and `#[UsesTrait]` |
+| [#5951](https://github.com/sebastianbergmann/phpunit/issues/5951) | `includeUncoveredFiles` configuration option              | 11.4.0 |                                     |

phpunit.xsd

@@ -64,7 +64,6 @@
             </xs:element>
         </xs:all>
         <xs:attribute name="pathCoverage" type="xs:boolean" default="false"/>
-        <xs:attribute name="includeUncoveredFiles" type="xs:boolean" default="true"/>
         <xs:attribute name="ignoreDeprecatedCodeUnits" type="xs:boolean" default="false"/>
         <xs:attribute name="disableCodeCoverageIgnore" type="xs:boolean" default="false"/>
     </xs:complexType>

src/TextUI/Configuration/Xml/Migration/MigrationBuilder.php

@@ -76,6 +76,10 @@
             RemoveCacheResultFileAttribute::class,
             RemoveCoverageElementCacheDirectoryAttribute::class,
         ],
+
+        '11.4' => [
+            RemoveCoverageElementIncludeUncoveredFilesAttribute::class,
+        ],
     ];
 
     /**

src/TextUI/Configuration/Xml/Migration/Migrations/RemoveCoverageElementIncludeUncoveredFilesAttribute.php

@@ -0,0 +1,34 @@
+<?php declare(strict_types=1);
+/*
+ * This file is part of PHPUnit.
+ *
+ * (c) Sebastian Bergmann <sebastian@phpunit.de>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+namespace PHPUnit\TextUI\XmlConfiguration;
+
+use DOMDocument;
+use DOMElement;
+
+/**
+ * @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
+ *
+ * @internal This class is not covered by the backward compatibility promise for PHPUnit
+ */
+final readonly class RemoveCoverageElementIncludeUncoveredFilesAttribute implements Migration
+{
+    public function migrate(DOMDocument $document): void
+    {
+        $node = $document->getElementsByTagName('coverage')->item(0);
+
+        if (!$node instanceof DOMElement || $node->parentNode === null) {
+            return;
+        }
+
+        if ($node->hasAttribute('includeUncoveredFiles')) {
+            $node->removeAttribute('includeUncoveredFiles');
+        }
+    }
+}

tests/_files/XmlConfigurationMigration/output-9.2.xml

@@ -3,8 +3,7 @@
          xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/11.4/phpunit.xsd"
          cacheDirectory=".phpunit.cache">
 
-    <coverage includeUncoveredFiles="true"
-              ignoreDeprecatedCodeUnits="true"
+    <coverage ignoreDeprecatedCodeUnits="true"
               disableCodeCoverageIgnore="true">
         <report>
             <clover outputFile="clover.xml"/>