TYPO3 v15 dev-main snapshot ()

Documentation/Changelog/9.0/Feature-83093-ReplaceCascadeWithTYPO3CMSExtbaseAnnotationORMCascade.rst

@@ -0,0 +1,64 @@
+.. include:: /Includes.rst.txt
+
+.. _feature-83093:
+
+======================================================================================
+Feature: #83093 - Replace @cascade with @TYPO3\\CMS\\Extbase\\Annotation\\ORM\\Cascade
+======================================================================================
+
+See :issue:`83093`
+
+Description
+===========
+
+As a successor to the :php:`@cascade` annotation, the doctrine annotation
+:php:`@TYPO3\CMS\Extbase\Annotation\ORM\Cascade` has been introduced.
+
+Example:
+
+.. code-block:: php
+
+	/**
+	 * @TYPO3\CMS\Extbase\Annotation\ORM\Cascade("remove")
+	 */
+	public $property;
+
+Doctrine annotations are actual defined classes, therefore you can also use the annotation with a use statement.
+
+Example:
+
+.. code-block:: php
+
+	use TYPO3\CMS\Extbase\Annotation\ORM\Cascade;
+
+.. code-block:: php
+
+	/**
+	 * @Cascade("remove")
+	 */
+	public $property;
+
+Used annotations can also be aliased which the core will most likely be using a lot in the future.
+
+Example:
+
+.. code-block:: php
+
+	use TYPO3\CMS\Extbase\Annotation as Extbase;
+
+.. code-block:: php
+
+	/**
+	 * @Extbase\ORM\Cascade("remove")
+	 */
+	public $property;
+
+
+Impact
+======
+
+In 9.x there is no actual impact. Both the simple :php:`@cascade` and
+:php:`@TYPO3\CMS\Extbase\Annotation\ORM\Cascade` can be used side by side.
+However, :php:`@cascade` is deprecated in 9.x and will be removed in version 10.
+
+.. index:: PHP-API, ext:extbase, FullyScanned