TYPO3 v15 dev-main snapshot ()

Documentation/Changelog/8.5/Deprecation-78670-DeprecatedCharsetConverterMethods.rst

@@ -0,0 +1,51 @@
+.. include:: /Includes.rst.txt
+
+.. _deprecation-78670:
+
+=========================================================
+Deprecation: #78670 - Deprecated CharsetConverter methods
+=========================================================
+
+See :issue:`78670`
+
+Description
+===========
+
+The `symfony/polyfill-mbstring` package provides us with `mb_string` functionality in all installations.
+Therefore some methods of :php:`CharsetConverter` have been marked as deprecated, since the equivalent `mb_string` functions can be used directly:
+
+- :php:`strlen()`: use :php:`mb_strlen()` directly
+- :php:`substr()`: use :php:`mb_substr()` directly
+- :php:`strtrunc()`: use :php:`mb_strcut()` directly
+- :php:`convCapitalize()`: use :php:`mb_convert_case()` directly
+- :php:`conv_case()`: use :php:`mb_strtolower()` or :php:`mb_strtoupper()` directly
+- :php:`utf8_substr()`: use :php:`mb_substr()` directly
+- :php:`utf8_strlen()`: use :php:`mb_strlen()` directly
+- :php:`utf8_strtrunc()`: use :php:`mb_strcut()` directly
+- :php:`utf8_strpos()`: use :php:`mb_strpos()` directly
+- :php:`utf8_strrpos()`: use :php:`mb_strrpos()` directly
+- :php:`utf8_byte2char_pos()`: no replacement
+- :php:`euc_strtrunc()`: use :php:`mb_strcut()` directly
+- :php:`euc_substr()`: use :php:`mb_substr()` directly
+- :php:`euc_strlen()`: use :php:`mb_strlen()` directly
+- :php:`euc_char2byte_pos()`: no replacement
+- :php:`$fourByteSets`: no replacement
+
+Impact
+======
+
+Calling the deprecated :php:`CharsetConverter` methods will trigger a deprecation log entry.
+
+
+Affected Installations
+======================
+
+Any installation using third party extensions leveraging the mentioned :php:`CharsetConverter` functionality.
+
+
+Migration
+=========
+
+Use the equivalent mb_string methods directly as denoted above.
+
+.. index:: PHP-API