Deprecate `StringUtil::(starts|ends)With()`
authorTim Düsterhus <duesterhus@woltlab.com>
Wed, 22 Sep 2021 09:59:11 +0000 (11:59 +0200)
committerTim Düsterhus <duesterhus@woltlab.com>
Wed, 22 Sep 2021 10:24:57 +0000 (12:24 +0200)
`\str_starts_with()` and `\str_ends_with()` are both polyfilled by
`symfony/polyfill-php80`.

wcfsetup/install/files/lib/util/StringUtil.class.php

index 8682217790a4e02e08e60517fec54a8c48709d74..674bd14c5988f3efc728f3a667cceb22968eabaf 100644 (file)
@@ -342,13 +342,7 @@ final class StringUtil
     }
 
     /**
-     * Checks whether $haystack starts with $needle, or not.
-     *
-     * @param string $haystack The string to be checked for starting with $needle
-     * @param string $needle The string to be found at the start of $haystack
-     * @param bool $ci Case insensitive or not. Default = false.
-     *
-     * @return  bool                True, if $haystack starts with $needle, false otherwise.
+     * @deprecated 5.5 Use \str_starts_with() instead. If a case-insensitive comparison is desired, manually call \mb_strtolower on both parameters.
      */
     public static function startsWith($haystack, $needle, $ci = false)
     {
@@ -361,12 +355,7 @@ final class StringUtil
     }
 
     /**
-     * Returns true if $haystack ends with $needle or if the length of $needle is 0.
-     *
-     * @param string $haystack
-     * @param string $needle
-     * @param bool $ci case insensitive
-     * @return  bool
+     * @deprecated 5.5 Use \str_ends_with() instead. If a case-insensitive comparison is desired, manually call \mb_strtolower on both parameters.
      */
     public static function endsWith($haystack, $needle, $ci = false)
     {