lucatume · lucatume · Jul 5, 2026 · Jul 5, 2026 · Jul 5, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -4,6 +4,10 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 
 ## [unreleased] Unreleased
 
+### Changed
+
+- Transpile the v4 unreleased changes (test suite split, dead-code removal, `MysqlServerController` port reuse, `parallel-run` fixes, `Utils\Filesystem` delegation to `symfony/filesystem`) down to the PHP 7.1-compatible v3.5 line (#817).
+
 ## [3.8.0] 2026-07-01;
 
 ### Changed

diff --git a/composer.json b/composer.json
@@ -68,7 +68,10 @@
     "psr-4": {
       "lucatume\\WPBrowser\\Tests\\FSTemplates\\": "tests/_support/FSTemplates",
       "lucatume\\WPBrowser\\Tests\\Traits\\": "tests/_support/Traits"
-    }
+    },
+    "classmap": [
+      "tests/_support/classmap"
+    ]
   },
   "extra": {
     "_hash": "484f861f69198089cab0e642f27e5653"

diff --git a/config/composer-35.json b/config/composer-35.json
@@ -67,7 +67,10 @@
   "autoload-dev": {
     "psr-4": {
       "lucatume\\WPBrowser\\Tests\\": "tests/_support"
-    }
+    },
+    "classmap": [
+      "tests/_support/classmap"
+    ]
   },
   "extra": {
     "_hash": "484f861f69198089cab0e642f27e5653"

diff --git a/src/Command/ParallelRun.php b/src/Command/ParallelRun.php
@@ -102,7 +102,6 @@ public function execute(InputInterface $input, OutputInterface $output): int
 
         $start = microtime(true);
 
-        $failed = false;
         $eventFiles = [];
         $eventOffsets = [];
         $logFiles = [];
@@ -175,7 +174,6 @@ public function execute(InputInterface $input, OutputInterface $output): int
                     $this->drainEvents($eventFiles[$i], $eventOffsets, $i, $aggregator);
                     if (!$p->isRunning()) {
                         if (!$p->isSuccessful()) {
-                            $failed = true;
                             $aggregator->recordCrash($i, $p->getExitCode() ?? -1);
                         }
                         unset($remaining[$i]);
@@ -206,7 +204,7 @@ public function execute(InputInterface $input, OutputInterface $output): int
             $this->teardownWorkers($workers, $cwd ?? '.', $output);
         }
 
-        return ($failed || $aggregator->hasFailures()) ? 1 : 0;
+        return $aggregator->hasFailures() ? 1 : 0;
     }
 
     /**
@@ -393,7 +391,7 @@ private function ensureMysqlStarted(string $cwd, OutputInterface $output): void
         $output->writeln('<info>MySQL not reachable at ' . $host . '; starting a managed instance...</info>');
 
         $baseDbName = (string)($envVars['WORDPRESS_DB_NAME'] ?? 'wordpress');
-        $dataDir    = $cwd . '/var/_output/_mysql_server';
+        $dataDir    = codecept_output_dir('_mysql_server');
         if (!is_dir($dataDir) && !mkdir($dataDir, 0777, true) && !is_dir($dataDir)) {
             throw new RuntimeException("Failed to create MySQL data directory: {$dataDir}");
         }

diff --git a/src/Command/ParallelRun/DotAggregator.php b/src/Command/ParallelRun/DotAggregator.php
@@ -167,8 +167,8 @@ public function flushSummary(float $wallClock): void
             $this->formatMemory(memory_get_peak_usage(true))
         ));
 
-        $style = ($this->totalFailures + $this->totalErrors + count($this->crashedWorkers)) > 0 ? 'error' : 'info';
-        $header = ($this->totalFailures + $this->totalErrors) > 0 ? 'FAILURES!' : 'OK';
+        $style = $this->hasFailures() ? 'error' : 'info';
+        $header = $this->hasFailures() ? 'FAILURES!' : 'OK';
         $this->output->writeln(sprintf('<%s>%s</%s>', $style, $header, $style));
         $this->output->writeln(sprintf(
             'Tests: %d, Assertions: %d, Failures: %d, Errors: %d, Skipped: %d',

diff --git a/src/Environment/Constants.php b/src/Environment/Constants.php
diff --git a/src/Events/EventDispatcherException.php b/src/Events/EventDispatcherException.php
diff --git a/src/Extension/MysqlServerController.php b/src/Extension/MysqlServerController.php
@@ -22,14 +22,14 @@ class MysqlServerController extends ServiceExtension
     public function start(OutputInterface $output): void
     {
         $pidFile = $this->getPidFile();
+        $port = $this->getPort();
 
-        if ($this->isProcessRunning($pidFile)) {
-            $output->writeln('MySQL server already running.');
+        if ($this->isProcessRunning($pidFile) || $this->isMysqlServerReachable($port)) {
+            $output->writeln("MySQL server already running on port $port.");
 
             return;
         }
 
-        $port = $this->getPort();
         $database = $this->getDatabase();
         $user = $this->getUser();
         $password = $this->getPassword();
@@ -60,6 +60,24 @@ public function getPidFile(): string
         return codecept_output_dir(self::PID_FILE_NAME);
     }
 
+    private function isMysqlServerReachable(int $port): bool
+    {
+        try {
+            new \PDO(
+                "mysql:host=127.0.0.1;port={$port}",
+                $this->getUser(),
+                $this->getPassword(),
+                [\PDO::ATTR_ERRMODE => \PDO::ERRMODE_EXCEPTION, \PDO::ATTR_TIMEOUT => 1]
+            );
+
+            return true;
+        } catch (\PDOException $e) {
+            // An auth or protocol-level error still proves a server is listening on the port;
+            // only a failure to connect at all (2002/2003) means no server is there.
+            return !in_array((int)$e->getCode(), [2002, 2003], true);
+        }
+    }
+
     private function getDatabase(): string
     {
         /** @var array{database?: string} $config */
@@ -130,7 +148,7 @@ public function getPort(): int
     public function stop(OutputInterface $output): void
     {
         $pidFile = $this->getPidFile();
-        $mysqlServerPid = (int)file_get_contents($pidFile);
+        $mysqlServerPid = is_file($pidFile) ? (int)file_get_contents($pidFile) : 0;
 
         if (!$mysqlServerPid) {
             $output->writeln('MySQL server not running.');
@@ -158,7 +176,7 @@ public function getPrettyName(): string
      */
     public function getInfo(): array
     {
-        $isRunning = is_file($this->getPidFile());
+        $isRunning = is_file($this->getPidFile()) || $this->isMysqlServerReachable($this->getPort());
 
         $info = [
             'running' => $isRunning ? 'yes' : 'no',

diff --git a/src/Generators/Date.php b/src/Generators/Date.php
@@ -47,16 +47,6 @@ public static function _time(): int
         return self::$time ?: time();
     }
 
-    /**
-     * Returns the 0 time string in WordPress specific format.
-     *
-     * @return string The "0000-00-00 00:00:00" string.
-     */
-    public static function zero(): string
-    {
-        return '0000-00-00 00:00:00';
-    }
-
     /**
      * The current date in GMT time.
      *

diff --git a/src/ManagedProcess/ManagedProcessInterface.php b/src/ManagedProcess/ManagedProcessInterface.php
@@ -9,7 +9,6 @@ interface ManagedProcessInterface
     public const ERR_PID = 3;
     public const ERR_PID_FILE = 4;
     public const ERR_BINARY_NOT_FOUND = 5;
-    public const ERR_STOP = 6;
     public const ERR_NOT_RUNNING = 7;
     public const ERR_PID_FILE_DELETE = 8;
 

diff --git a/src/Module/Support/DbDump.php b/src/Module/Support/DbDump.php
@@ -37,14 +37,26 @@ class DbDump
      * @return array<string> The modified SQL array.
      */
     public function replaceSiteDomainInSqlArray(array $sql): array
+    {
+        return $this->replaceSiteDomainInJoinedSql($sql, false);
+    }
+
+    /**
+     * @param array<string> $sql
+     *
+     * @return array<string>
+     */
+    private function replaceSiteDomainInJoinedSql(array $sql, bool $multisite): array
     {
         if (empty($sql)) {
             return [];
         }
 
         $delimiter = md5(uniqid('delim', true));
         $joined = implode($delimiter, $sql);
-        $replaced = $this->replaceSiteDomainInSqlString($joined);
+        $replaced = $multisite ?
+            $this->replaceSiteDomainInMultisiteSqlString($joined)
+            : $this->replaceSiteDomainInSqlString($joined);
 
         return explode($delimiter, $replaced);
     }
@@ -58,15 +70,7 @@ public function replaceSiteDomainInSqlArray(array $sql): array
      */
     public function replaceSiteDomainInMultisiteSqlArray(array $sql): array
     {
-        if (empty($sql)) {
-            return [];
-        }
-
-        $delimiter = md5(uniqid('delim', true));
-        $joined = implode($delimiter, $sql);
-        $replaced = $this->replaceSiteDomainInMultisiteSqlString($joined);
-
-        return explode($delimiter, $replaced);
+        return $this->replaceSiteDomainInJoinedSql($sql, true);
     }
 
     /**

diff --git a/src/Module/WPCLI.php b/src/Module/WPCLI.php
@@ -396,7 +396,7 @@ public function dontSeeInShellOutput(string $text): void
      */
     public function seeShellOutputMatches(string $regex): void
     {
-        $this->assertMatchesRegularExpression($regex, $this->grabLastShellOutput());
+        $this->assertRegExp($regex, $this->grabLastShellOutput());
     }
 
     /**
@@ -415,7 +415,7 @@ public function seeShellOutputMatches(string $regex): void
      */
     public function dontSeeShellOutputMatches(string $regex): void
     {
-        $this->assertDoesNotMatchRegularExpression($regex, $this->grabLastShellOutput());
+        $this->assertNotRegExp($regex, $this->grabLastShellOutput());
     }
 
     /**

diff --git a/src/Module/WPDb.php b/src/Module/WPDb.php
@@ -3058,9 +3058,8 @@ protected function _seeTableInDatabase(string $table): bool
         $sth = $dbh->prepare('SHOW TABLES LIKE :table');
         $this->debugSection('Query', $sth->queryString);
         $sth->execute(['table' => $table]);
-        $count = $sth->rowCount();
 
-        return $count === 1;
+        return $sth->rowCount() === 1;
     }
 
     /**

diff --git a/src/Module/WPFilesystem.php b/src/Module/WPFilesystem.php
@@ -379,7 +379,7 @@ public function dontSeeUploadedFileFound(string $file, $date = null): void
         if (method_exists(Assert::class, 'assertFileDoesNotExist')) {
             Assert::assertFileDoesNotExist($this->getUploadsPath($file, $date));
         } else {
-            Assert::assertFileDoesNotExist($this->getUploadsPath($file, $date));
+            Assert::assertFileNotExists($this->getUploadsPath($file, $date));
         }
     }