Deprecate non-finite float values (#788)

Author: GrahamCampbell

CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## 2.12.0 - Upcoming
+
+### Deprecated
+
+- Deprecated non-finite float values that guzzlehttp/psr7 3.0 will reject
+
 ## 2.11.1 - 2026-06-12
 
 ### Fixed

src/Query.php

@@ -127,6 +127,12 @@ public static function build(array $params, $encoding = PHP_QUERY_RFC3986, bool
     private static function normalizeNonFiniteFloat($value)
     {
         if (is_float($value) && !is_finite($value)) {
+            \trigger_deprecation(
+                'guzzlehttp/psr7',
+                '2.12',
+                'Passing a non-finite float to Query::build() is deprecated; guzzlehttp/psr7 3.0 rejects non-finite floats.'
+            );
+
             return is_nan($value) ? 'NAN' : ($value > 0 ? 'INF' : '-INF');
         }
 

src/Uri.php

@@ -386,6 +386,12 @@ public static function withQueryValues(UriInterface $uri, array $keyValueArray):
     private static function stringifyQueryValue($value): string
     {
         if (is_float($value) && !is_finite($value)) {
+            \trigger_deprecation(
+                'guzzlehttp/psr7',
+                '2.12',
+                'Passing a non-finite float to Uri::withQueryValues() is deprecated; guzzlehttp/psr7 3.0 rejects non-finite floats.'
+            );
+
             return is_nan($value) ? 'NAN' : ($value > 0 ? 'INF' : '-INF');
         }
 

src/Utils.php

@@ -473,6 +473,12 @@ public static function streamFor($resource = '', array $options = []): StreamInt
             // Convert non-finite floats explicitly, as implicit coercion of
             // NAN emits a warning on PHP 8.5.
             if (is_float($resource) && !is_finite($resource)) {
+                \trigger_deprecation(
+                    'guzzlehttp/psr7',
+                    '2.12',
+                    'Passing a non-finite float to Utils::streamFor() is deprecated; guzzlehttp/psr7 3.0 rejects non-finite floats.'
+                );
+
                 $resource = is_nan($resource) ? 'NAN' : ($resource > 0 ? 'INF' : '-INF');
             }