[PHP 8.4] Fixes for implicit nullability deprecation (#865)

Co-authored-by: jrfnl <jrfnl@users.noreply.github.com>

src/Cookie.php

@@ -470,13 +470,19 @@ public static function parse($cookie_header, $name = '', $reference_time = null)
 	 * @param \WpOrg\Requests\Iri|null $origin URI for comparing cookie origins
 	 * @param int|null $time Reference time for expiration calculation
 	 * @return array
+	 *
+	 * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $origin argument is not null or an instance of the Iri class.
 	 */
-	public static function parse_from_headers(Headers $headers, Iri $origin = null, $time = null) {
+	public static function parse_from_headers(Headers $headers, $origin = null, $time = null) {
 		$cookie_headers = $headers->getValues('Set-Cookie');
 		if (empty($cookie_headers)) {
 			return [];
 		}
 
+		if ($origin !== null && !($origin instanceof Iri)) {
+			throw InvalidArgument::create(2, '$origin', Iri::class . ' or null', gettype($origin));
+		}
+
 		$cookies = [];
 		foreach ($cookie_headers as $header) {
 			$parsed = self::parse($header, '', $time);

tests/CookieTest.php

@@ -807,4 +807,35 @@ public function testParseFromHeadersInvalidReferenceTime() {
 
 		Cookie::parse_from_headers($headers, $origin, 'now');
 	}
+
+	/**
+	 * Verify parsing of cookies fails with an exception if the $origin parameter is passed anything but `null`
+	 * or an instance of Iri.
+	 *
+	 * @dataProvider dataParseFromHeadersInvalidOrigin
+	 *
+	 * @covers ::parse_from_headers
+	 *
+	 * @param mixed $input Invalid parameter input.
+	 *
+	 * @return void
+	 */
+	public function testParseFromHeadersInvalidOrigin($input) {
+		$this->expectException(InvalidArgument::class);
+		$this->expectExceptionMessage('Argument #2 ($origin) must be of type WpOrg\Requests\Iri or null');
+
+		$headers               = new Headers();
+		$headers['Set-Cookie'] = 'name=value';
+
+		Cookie::parse_from_headers($headers, $input);
+	}
+
+	/**
+	 * Data Provider.
+	 *
+	 * @return array
+	 */
+	public static function dataParseFromHeadersInvalidOrigin() {
+		return TypeProviderHelper::getAllExcept(TypeProviderHelper::GROUP_NULL);
+	}
 }