Support auto encoding

Author: VincentLanglet

src/Type/Php/MbConvertEncodingFunctionReturnTypeExtension.php

@@ -20,6 +20,8 @@
 use PHPStan\Type\UnionType;
 use function count;
 use function str_contains;
+use function strtolower;
+use function trim;
 
 #[AutowiredService]
 final class MbConvertEncodingFunctionReturnTypeExtension implements DynamicFunctionReturnTypeExtension
@@ -81,7 +83,10 @@ public function getTypeFromFunctionCall(
 				$constantStrings = $fromEncodingArgType->getConstantStrings();
 				if (count($constantStrings) > 0) {
 					foreach ($constantStrings as $constantString) {
-						if (str_contains($constantString->getValue(), ',')) {
+						if (
+							str_contains($constantString->getValue(), ',')
+							|| trim(strtolower($constantString->getValue())) === 'auto'
+						) {
 							$returnFalseIfCannotDetectEncoding = true;
 							break;
 						}

tests/PHPStan/Analyser/nsrt/mb-convert-encoding-php7.php

@@ -29,4 +29,7 @@ function test_mb_convert_encoding(
 	\PHPStan\Testing\assertType('list<int>|false', mb_convert_encoding($intList, 'UTF-8'));
 	\PHPStan\Testing\assertType('array{foo: string, bar: int, baz: string}|string|false', mb_convert_encoding($union, 'UTF-8'));
 	\PHPStan\Testing\assertType('array|string|false', mb_convert_encoding($int, 'UTF-8'));
+
+	\PHPStan\Testing\assertType('string|false', mb_convert_encoding($string, 'UTF-8', 'auto'));
+	\PHPStan\Testing\assertType('string|false', mb_convert_encoding($string, 'UTF-8', ' AUTO '));
 };

tests/PHPStan/Analyser/nsrt/mb-convert-encoding-php8.php

@@ -42,4 +42,7 @@ function test_mb_convert_encoding(
 	\PHPStan\Testing\assertType('list<string>', mb_convert_encoding($stringList, 'UTF-8', ['FOO']));
 	\PHPStan\Testing\assertType('list<string>|false', mb_convert_encoding($stringList, 'UTF-8', ['FOO', 'BAR']));
 	\PHPStan\Testing\assertType('list<string>', mb_convert_encoding($stringList, 'UTF-8', ['FOO,BAR']));
+
+	\PHPStan\Testing\assertType('string|false', mb_convert_encoding($string, 'UTF-8', 'auto'));
+	\PHPStan\Testing\assertType('string|false', mb_convert_encoding($string, 'UTF-8', ' AUTO '));
 };