[php-src] master: NEWS/UPGRADING for return in finally deprecation

Author: Gina Peter Banyard (Girgias)
Date: 2026-08-18T20:16:04+01:00

Commit: https://github.com/php/php-src/commit/f7e9b5a820af81d7d15f38b02b9904ebb56eec50
Raw diff: https://github.com/php/php-src/commit/f7e9b5a820af81d7d15f38b02b9904ebb56eec50.diff

NEWS/UPGRADING for return in finally deprecation

Changed paths:
  M  NEWS
  M  UPGRADING


Diff:

diff --git a/NEWS b/NEWS
index 91406b2905c6..42768c2904ee 100644
--- a/NEWS
+++ b/NEWS
@@ -8,6 +8,8 @@ PHP                                                                        NEWS
   . Fixed GH-10497 (Allow direct mutation of objects stored in constants or
     class constants via OBJ->prop = $val). (Khaled Alam)
   . Reverted GH-22833, which attempted to fix bug GH-18985. (ilutov)
+  . Using the return statement in a finally block is now deprecated.
+    (aldemeery)
 
 - Curl:
   . Set content length using CURLOPT_POSTFIELDSIZE_LARGE instead of
diff --git a/UPGRADING b/UPGRADING
index e32c1fe55748..e8eec0d0bbdd 100644
--- a/UPGRADING
+++ b/UPGRADING
@@ -454,6 +454,8 @@ PHP 8.6 UPGRADE NOTES
 
 - Core:
   . Using "namespace" as a class constant name is deprecated.
+  . Using the return statement in a finally block is now deprecated.
+    RFC: https://wiki.php.net/rfc/deprecations_php_8_6#deprecate_returning_from_a_finally_block
   . Specifying a return type of array|null / ?array for __debugInfo() is now
     deprecated. Specify array instead.
   . Returning values from __construct() and __destruct() is now deprecated.