Merge pull request #9073 from therealryanbonham/9066_fix_get_headers_signature

Update Call Maps and Signature for get_headers

dictionaries/CallMap.php

@@ -3699,7 +3699,7 @@ return [
 'get_defined_functions' => ['array{internal: list<callable-string>, user: list<callable-string>}', 'exclude_disabled='=>'bool'],
 'get_defined_vars' => ['array'],
 'get_extension_funcs' => ['list<callable-string>|false', 'extension'=>'string'],
-'get_headers' => ['array|false', 'url'=>'string', 'associative='=>'int', 'context='=>'resource'],
+'get_headers' => ['array|false', 'url'=>'string', 'associative='=>'bool', 'context='=>'?resource'],
 'get_html_translation_table' => ['array', 'table='=>'int', 'flags='=>'int', 'encoding='=>'string'],
 'get_include_path' => ['string'],
 'get_included_files' => ['list<string>'],

dictionaries/CallMap_71_delta.php

@@ -48,7 +48,7 @@ return [
     ],
     'get_headers' => [
       'old' => ['array|false', 'url'=>'string', 'associative='=>'int'],
-      'new' => ['array|false', 'url'=>'string', 'associative='=>'int', 'context='=>'resource'],
+      'new' => ['array|false', 'url'=>'string', 'associative='=>'int', 'context='=>'?resource'],
     ],
     'getopt' => [
       'old' => ['array<string,string|false|list<string|false>>|false', 'short_options'=>'string', 'long_options='=>'array'],

dictionaries/CallMap_80_delta.php

@@ -673,6 +673,10 @@ return [
       'old' => ['list<string>|null', 'object_or_class'=>'mixed'],
       'new' => ['list<string>', 'object_or_class'=>'object|class-string'],
     ],
+    'get_headers' => [
+      'old' => ['array|false', 'url'=>'string', 'associative='=>'int', 'context='=>'?resource'],
+      'new' => ['array|false', 'url'=>'string', 'associative='=>'bool', 'context='=>'?resource'],
+    ],
     'get_parent_class' => [
       'old' => ['class-string|false', 'object_or_class='=>'mixed'],
       'new' => ['class-string|false', 'object_or_class='=>'object|class-string'],

stubs/CoreGenericFunctions.phpstub

@@ -1482,7 +1482,7 @@ function bin2hex(string $string): string {}
  *
  * @param resource|null $context
  *
- * @return ($associative is 0 ? list<string> : array<string, string|list<string>>)|false
+ * @return ($associative is false|0 ? list<string> : array<string, string|list<string>>)|false
  *
  * @psalm-taint-sink ssrf $url
  */

stubs/Php80.phpstub

@@ -221,3 +221,14 @@ class DatePeriod implements IteratorAggregate
     /** @psalm-return (Start is string ? (Traversable<int, DateTime>&Iterator) : (Traversable<int, Start>&Iterator)) */
     public function getIterator(): Iterator {}
 }
+
+/**
+ * @psalm-pure
+ *
+ * @param resource|null $context
+ *
+ * @return ($associative is false|0 ? list<string> : array<string, string|list<string>>)|false
+ *
+ * @psalm-taint-sink ssrf $url
+ */
+function get_headers(string $url, bool $associative = false, $context = null) : array|false {}

tests/FunctionCallTest.php

@@ -2045,6 +2045,24 @@ class FunctionCallTest extends TestCase
                     }
                 ',
             ],
+            'getHeadersAssociativeIn8x' => [
+                'code' => '<?php
+                    $a = get_headers("https://psalm.dev", true);',
+                'assertions' => [
+                    '$a' => 'array<string, list<string>|string>|false',
+                ],
+                'ignored_issues' => [],
+                'php_version' => '8.0',
+            ],
+            'getHeadersAssociativeIn7x' => [
+                'code' => '<?php
+                    $a = get_headers("https://psalm.dev", 0);',
+                'assertions' => [
+                    '$a' => 'false|list<string>',
+                ],
+                'ignored_issues' => [],
+                'php_version' => '7.0',
+            ],
         ];
     }
 

tests/Internal/Codebase/InternalCallMapHandlerTest.php

@@ -211,7 +211,6 @@ class InternalCallMapHandlerTest extends TestCase
         'finfo::file',
         'finfo::set_flags',
         'generator::throw',
-        'get_headers',
         'globiterator::__construct',
         'globiterator::getfileinfo',
         'globiterator::getpathinfo',