diff --git a/language/fibers.xml b/language/fibers.xml
index 3da63d75d73f..eae91489d4c6 100644
--- a/language/fibers.xml
+++ b/language/fibers.xml
@@ -36,7 +36,9 @@
- Due to current limitations it is not possible to switch fibers in the destructor of an object.
+ Prior to PHP 8.4.0, switching fibers during the execution of an object
+ destructor was not
+ allowed.
diff --git a/language/oop5/decon.xml b/language/oop5/decon.xml
index ee83e45ebe2b..7032fe6b1261 100644
--- a/language/oop5/decon.xml
+++ b/language/oop5/decon.xml
@@ -343,6 +343,26 @@ $obj = new MyDestructableClass();
exit. Calling exit in a destructor
will prevent the remaining shutdown routines from executing.
+
+ If a destructor creates new references to its object, it will not be called
+ a second time when the reference count reaches zero again or during the
+ shutdown sequence.
+
+
+ As of PHP 8.4.0, when
+ cycle collection
+ occurs during the execution of a
+ Fiber, the destructors of objects
+ scheduled for collection are executed in a separate Fiber, called the
+ gc_destructor_fiber.
+ If this Fiber is suspended, a new one will be created to execute any
+ remaining destructors.
+ The previous gc_destructor_fiber will no longer be
+ referenced by the garbage collector and may be collected if it is not
+ referenced elsewhere.
+ Objects whose destructor are suspended will not be collected until the
+ destructor returns or the Fiber itself is collected.
+
Destructors called during the script shutdown have HTTP headers already