Closes sebastianbergmann#834

Author: sebastianbergmann

ChangeLog.md

@@ -2,6 +2,12 @@
 
 All notable changes are documented in this file using the [Keep a CHANGELOG](http://keepachangelog.com/) principles.
 
+## [9.2.4] - 2020-11-27
+
+### Added
+
+* [#834](https://github.com/sebastianbergmann/php-code-coverage/issues/834): Support `XDEBUG_MODE` environment variable
+
 ## [9.2.3] - 2020-10-30
 
 ### Changed
@@ -306,6 +312,7 @@ All notable changes are documented in this file using the [Keep a CHANGELOG](htt
 * Class names are now abbreviated (unqualified name shown, fully qualified name shown on hover) in the file view of the HTML report
 * Update HTML report to Bootstrap 4
 
+[9.2.4]: https://github.com/sebastianbergmann/php-code-coverage/compare/9.2.3...9.2.4
 [9.2.3]: https://github.com/sebastianbergmann/php-code-coverage/compare/9.2.2...9.2.3
 [9.2.2]: https://github.com/sebastianbergmann/php-code-coverage/compare/9.2.1...9.2.2
 [9.2.1]: https://github.com/sebastianbergmann/php-code-coverage/compare/9.2.0...9.2.1

src/Driver/Xdebug3Driver.php

@@ -14,7 +14,9 @@
 use const XDEBUG_CC_UNUSED;
 use const XDEBUG_FILTER_CODE_COVERAGE;
 use const XDEBUG_PATH_INCLUDE;
+use function explode;
 use function extension_loaded;
+use function getenv;
 use function in_array;
 use function ini_get;
 use function phpversion;
@@ -52,7 +54,14 @@ public function __construct(Filter $filter)
             );
         }
 
-        if (!ini_get('xdebug.mode') || !in_array('coverage', explode(',', ini_get('xdebug.mode')), true)) {
+        $mode = getenv('XDEBUG_MODE');
+
+        if ($mode === false) {
+            $mode = ini_get('xdebug.mode');
+        }
+
+        if ($mode === false ||
+            !in_array('coverage', explode(',', $mode), true)) {
             throw new Xdebug3NotEnabledException;
         }
 

src/Exception/Xdebug2NotEnabledException.php

@@ -16,6 +16,6 @@ final class Xdebug2NotEnabledException extends RuntimeException implements Excep
 {
     public function __construct()
     {
-        parent::__construct('xdebug.coverage_enable=On has to be set in php.ini');
+        parent::__construct('xdebug.coverage_enable=On has to be set');
     }
 }

src/Exception/Xdebug3NotEnabledException.php

@@ -16,6 +16,6 @@ final class Xdebug3NotEnabledException extends RuntimeException implements Excep
 {
     public function __construct()
     {
-        parent::__construct('xdebug.mode=coverage has to be set in php.ini');
+        parent::__construct('XDEBUG_MODE=coverage or xdebug.mode=coverage has to be set');
     }
 }

src/Version.php

@@ -22,7 +22,7 @@ final class Version
     public static function id(): string
     {
         if (self::$version === null) {
-            self::$version = (new VersionId('9.2.3', dirname(__DIR__)))->getVersion();
+            self::$version = (new VersionId('9.2.4', dirname(__DIR__)))->getVersion();
         }
 
         return self::$version;