Introduce bootstrapFiles config option; deprecate bootstrap config option

Author: ondrejmirtes

build/phpstan.neon

@@ -7,7 +7,8 @@ includes:
 	- ../conf/bleedingEdge.neon
 	- ../phpstan-baseline.neon
 parameters:
-	bootstrap: %rootDir%/tests/phpstan-bootstrap.php
+	bootstrapFiles:
+		- %rootDir%/tests/phpstan-bootstrap.php
 	excludes_analyse:
 		- %rootDir%/src/Reflection/SignatureMap/functionMap.php
 		- %rootDir%/src/Reflection/SignatureMap/functionMetadata.php

conf/config.neon

@@ -1,5 +1,6 @@
 parameters:
 	bootstrap: null
+	bootstrapFiles: []
 	excludes_analyse: []
 	autoload_directories: []
 	autoload_files: []
@@ -132,6 +133,7 @@ extensions:
 
 parametersSchema:
 	bootstrap: schema(string(), nullable())
+	bootstrapFiles: listOf(string())
 	excludes_analyse: listOf(string())
 	autoload_directories: listOf(string())
 	autoload_files: listOf(string())

src/Command/CommandHelper.php

@@ -310,9 +310,19 @@ public static function begin(
 
 		$bootstrapFile = $container->getParameter('bootstrap');
 		if ($bootstrapFile !== null) {
+			$errorOutput->writeLineFormatted('⚠️  You\'re using a deprecated config option <fg=cyan>bootstrap</>. ⚠️️');
+			$errorOutput->writeLineFormatted('');
+			$errorOutput->writeLineFormatted('This option has been replaced with <fg=cyan>bootstrapFiles</> which accepts a list of files');
+			$errorOutput->writeLineFormatted('to execute before the analysis.');
+			$errorOutput->writeLineFormatted('');
+
 			self::executeBootstrapFile($bootstrapFile, $container, $errorOutput, $debugEnabled);
 		}
 
+		foreach ($container->getParameter('bootstrapFiles') as $bootstrapFileFromArray) {
+			self::executeBootstrapFile($bootstrapFileFromArray, $container, $errorOutput, $debugEnabled);
+		}
+
 		/** @var FileFinder $fileFinder */
 		$fileFinder = $container->getByType(FileFinder::class);
 

src/DependencyInjection/NeonAdapter.php

@@ -14,7 +14,7 @@
 class NeonAdapter implements Adapter
 {
 
-	public const CACHE_KEY = 'v7';
+	public const CACHE_KEY = 'v8';
 
 	private const PREVENT_MERGING_SUFFIX = '!';
 
@@ -95,6 +95,7 @@ public function process(array $arr, string $fileKey, string $file): array
 				'[parameters][ignoreErrors][][paths][]',
 				'[parameters][ignoreErrors][][path]',
 				'[parameters][bootstrap]',
+				'[parameters][bootstrapFiles][]',
 				'[parameters][tmpDir]',
 				'[parameters][memoryLimitFile]',
 				'[parameters][benchmarkFile]',

tests/PHPStan/Command/CommandHelperTest.php

@@ -166,6 +166,9 @@ public function dataResolveRelativePaths(): array
 				__DIR__ . '/relative-paths/root.neon',
 				[
 					'bootstrap' => __DIR__ . DIRECTORY_SEPARATOR . 'relative-paths' . DIRECTORY_SEPARATOR . 'here.php',
+					'bootstrapFiles' => [
+						__DIR__ . DIRECTORY_SEPARATOR . 'relative-paths' . DIRECTORY_SEPARATOR . 'here.php',
+					],
 					'autoload_files' => [
 						__DIR__ . DIRECTORY_SEPARATOR . 'relative-paths' . DIRECTORY_SEPARATOR . 'here.php',
 						__DIR__ . DIRECTORY_SEPARATOR . 'relative-paths' . DIRECTORY_SEPARATOR . 'test' . DIRECTORY_SEPARATOR . 'there.php',

tests/PHPStan/Command/relative-paths/root.neon

@@ -1,5 +1,7 @@
 parameters:
 	bootstrap: here.php
+	bootstrapFiles:
+		- here.php
 	autoload_files:
 		- here.php
 		- test/there.php