From: Nikita Popov <nikita.ppv@gmail.com>
Date: Fri, 2 Oct 2020 07:39:15 +0000 (+0200)
Subject: Add UPGRADING note for substr() behavior
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=d7243ce2912375bbdccda318f754a45825d6195c;p=php

Add UPGRADING note for substr() behavior

[ci skip]
---

diff --git a/UPGRADING b/UPGRADING
index 05c8eef1e9..0c15b1ecbe 100644
--- a/UPGRADING
+++ b/UPGRADING
@@ -608,6 +608,9 @@ PHP 8.0 UPGRADE NOTES
   . Calling crypt() without an explicit salt is no longer supported. If you
     would like to produce a strong hash with an auto-generated salt, use
     password_hash() instead.
+  . substr(), mb_substr(), iconv_substr() and grapheme_substr() now consistently
+    clamp out-of-bounds offsets to the string boundary. Previously, false was
+    returned instead of the empty string in some cases.
 
 - Sysvmsg:
   . msg_get_queue() will now return an SysvMessageQueue object rather than a