Test distribution of turbo-ext

compiler/build/box.json

@@ -9,13 +9,15 @@
   "files": [
 	"preload.php",
 	"vendor/composer/installed.php",
-    "vendor/attributes.php"
+    "vendor/attributes.php",
+    "turbo-ext/shadowed-classes.json"
   ],
   "directories": [
     "conf",
     "src",
     "resources",
-    "stubs"
+    "stubs",
+    "turbo-ext/stubs"
   ],
   "force-autodiscovery": true,
   "output": "tmp/phpstan.phar",

compiler/build/scoper.inc.php

@@ -240,6 +240,10 @@ function (string $filePath, string $prefix, string $content): string {
 	],
 	'exclude-namespaces' => [
 		'PHPStan',
+		// the native turbo extension's classes — must match the loaded
+		// extension exactly, never prefixed (segment-aware matching means the
+		// PHPStan entry above does not cover this name)
+		'PHPStanTurbo',
 		'PHPUnit',
 		'PhpParser',
 		'Hoa',

compiler/src/Console/PrepareCommand.php

@@ -173,6 +173,28 @@ private function buildPreloadScript(): void
 		if ($root === false) {
 			return;
 		}
+
+		// The turbo extension shadows these classes with stubs that
+		// TurboExtensionEnabler declares before the Composer autoloader
+		// registers; preloading the PHP twins by path would then fatal with a
+		// class redeclaration. Without the extension they load lazily through
+		// the autoloader.
+		$manifestContents = file_get_contents($root . '/turbo-ext/shadowed-classes.json');
+		if ($manifestContents === false) {
+			throw new ShouldNotHappenException('Could not read turbo-ext/shadowed-classes.json');
+		}
+
+		/** @var array<string, array{php: string, cpp: string, vendored?: bool}> $manifest */
+		$manifest = json_decode($manifestContents, true);
+		$shadowedFiles = [];
+		foreach ($manifest as $entry) {
+			$shadowedFile = realpath($root . '/' . $entry['php']);
+			if ($shadowedFile === false) {
+				throw new ShouldNotHappenException(sprintf('Shadowed file %s does not exist', $entry['php']));
+			}
+			$shadowedFiles[] = $shadowedFile;
+		}
+
 		$output = '';
 		foreach ($finder->files()->name('*.php')->in([
 			$this->buildDir . '/src',
@@ -185,6 +207,9 @@ private function buildPreloadScript(): void
 			if ($realPath === false) {
 				return;
 			}
+			if (in_array($realPath, $shadowedFiles, true)) {
+				continue;
+			}
 			if (in_array($realPath, [
 				$vendorDir . '/nikic/php-parser/lib/PhpParser/Node/Expr/ArrayItem.php',
 				$vendorDir . '/nikic/php-parser/lib/PhpParser/Node/Expr/ClosureUse.php',

src/Process/ProcessHelper.php

@@ -3,6 +3,7 @@
 namespace PHPStan\Process;
 
 use PHPStan\Command\AnalyseCommand;
+use PHPStan\Turbo\TurboExtensionSelector;
 use Symfony\Component\Console\Input\InputInterface;
 use function array_merge;
 use function escapeshellarg;
@@ -43,6 +44,13 @@ public static function getWorkerCommand(
 			$processCommandArray[] = 'memory_limit=' . ini_get('memory_limit');
 		}
 
+		$turboExtension = TurboExtensionSelector::findExtensionForWorkers();
+		if ($turboExtension !== null) {
+			$processCommandArray[] = '-d';
+			// quote value so PHP will parse it as a string when the path contains a bitwise operator like ~
+			$processCommandArray[] = 'extension=' . escapeshellarg("'" . $turboExtension . "'");
+		}
+
 		foreach ([$mainScript, $commandName] as $arg) {
 			$processCommandArray[] = escapeshellarg($arg);
 		}

src/Reflection/BetterReflection/BetterReflectionSourceLocatorFactory.php

@@ -28,6 +28,7 @@
 use PHPStan\Reflection\BetterReflection\SourceLocator\RewriteClassAliasSourceLocator;
 use PHPStan\Reflection\BetterReflection\SourceLocator\SkipClassAliasSourceLocator;
 use PHPStan\Reflection\BetterReflection\SourceLocator\SkipPolyfillSourceLocator;
+use PHPStan\Turbo\TurboExtensionEnabler;
 use function array_merge;
 use function array_unique;
 use function count;
@@ -124,6 +125,17 @@ public function create(): SourceLocator
 				$fileLocators[] = $this->optimizedSingleFileSourceLocatorRepository->getOrCreate($analysedFile);
 			}
 
+			if (TurboExtensionEnabler::isActive()) {
+				// With the turbo extension active, the shadowed class names are
+				// declared by the stub shells extending the native classes;
+				// reflection has to keep seeing the real implementations, which
+				// the AutoloadSourceLocator below can no longer provide (it
+				// would resolve the class names to the stub files).
+				foreach (TurboExtensionEnabler::getShadowedClassSourceFiles() as $shadowedClassSourceFile) {
+					$fileLocators[] = $this->optimizedSingleFileSourceLocatorRepository->getOrCreate($shadowedClassSourceFile);
+				}
+			}
+
 			$directories = array_unique(array_merge($analysedDirectories, $this->scanDirectories));
 			foreach ($directories as $directory) {
 				$fileLocators[] = $this->optimizedDirectorySourceLocatorRepository->getOrCreate($directory);