TYPO3 v15 dev-main snapshot ()

2026-08-10 22:31:09 +02:00
commit af8cc155b5
6818 changed files with 642608 additions and 0 deletions
@@ -0,0 +1,53 @@
+.. include:: /Includes.rst.txt
+
+.. _deprecation-104325-1720298173:
+
+=====================================================
+Deprecation: #104325 - DiffUtility->makeDiffDisplay()
+=====================================================
+
+See :issue:`104325`
+
+Description
+===========
+
+Method :php:`\TYPO3\CMS\Core\Utility\DiffUtility->makeDiffDisplay()`
+and class property :php:`DiffUtility->stripTags` have been
+deprecated in favor of new method :php:`DiffUtility->diff()`.
+The new method no longer applies :php:`strip_tags()` to the input strings.
+
+This change makes class :php-short:`\TYPO3\CMS\Core\Utility\DiffUtility` stateless: Property
+:php:`$stripTags` will vanish in v14.
+
+Impact
+======
+
+Using method :php:`DiffUtility->makeDiffDisplay()` will trigger a
+deprecation level error message.
+
+
+Affected installations
+======================
+
+Instances with extensions calling :php:`DiffUtility->makeDiffDisplay()`.
+
+
+Migration
+=========
+
+If :php:`DiffUtility->stripTags` *is not* explicitly set to false, a typical
+migration looks like this:
+
+.. code-block:: php
+
+    // before
+    $diffUtility->DiffUtility->makeDiffDisplay($from, $to);
+
+    // after
+    $diffUtility->DiffUtility->diff(strip_tags($from), stripTags($to));
+
+If :php:`DiffUtility->stripTags = false` is set before calling
+:php:`DiffUtility->makeDiffDisplay()`, method :php:`diff()` can be called
+as before, and :php:`DiffUtility->stripTags = false` can be removed.
+
+.. index:: PHP-API, FullyScanned, ext:core