From 679a7fbfdbea18da9107a876b86ea84d3310d7ff Mon Sep 17 00:00:00 2001
From: IWASE Shigeaki <siwa32@gmail.com>
Date: Tue, 31 Dec 2024 00:44:55 +0900
Subject: [PATCH 1/2] =?UTF-8?q?Add=20more=20details=20about=20WeakReferenc?=
 =?UTF-8?q?es=20(#3976)=E3=81=AE=E5=8F=96=E3=82=8A=E8=BE=BC=E3=81=BF?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

https://github.com/php/doc-en/commit/cd391e65a613a729f9bbded2b1249e2d7143400c
---
 language/predefined/weakreference.xml | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/language/predefined/weakreference.xml b/language/predefined/weakreference.xml
index f5c97ffec7..e406de5e35 100644
--- a/language/predefined/weakreference.xml
+++ b/language/predefined/weakreference.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 14767af0f05dffa6fdb9b49e1a1f4e9ca7022a60 Maintainer: mumumu Status: ready -->
+<!-- EN-Revision: cd391e65a613a729f9bbded2b1249e2d7143400c Maintainer: mumumu Status: ready -->
 <reference xml:id="class.weakreference" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
 
  <title>WeakReference クラス</title>
@@ -14,6 +14,10 @@
    <para>
     弱い参照により、オブジェクトが破棄されるのを妨げないオブジェクトへの参照を保持することが可能です。
     この機能は、キャッシュのようなデータ構造を実装するのに役立ちます。
+    元のオブジェクトが破棄されている場合、<methodname>WeakReference::get</methodname>
+    メソッドを呼び出すと &null; を返します。
+    元のオブジェクトは、<link linkend="features.gc.refcounting-basics">refcount</link> が 0 になると破棄されます。
+    弱い参照を作成しても、参照されているオブジェクトの <literal>refcount</literal> は増加しません。
    </para>
    <para>
     <classname>WeakReference</classname> クラスはシリアライズできません。
@@ -51,11 +55,16 @@
      <programlisting role="php">
 <![CDATA[
 <?php
+
 $obj = new stdClass;
 $weakref = WeakReference::create($obj);
+
 var_dump($weakref->get());
+
 unset($obj);
+
 var_dump($weakref->get());
+
 ?>
 ]]>
      </programlisting>

From 4d100fd3a173fd2fe49d361ddceae1a9d097ddbf Mon Sep 17 00:00:00 2001
From: IWASE Shigeaki <siwa32@gmail.com>
Date: Tue, 31 Dec 2024 02:55:04 +0900
Subject: [PATCH 2/2] =?UTF-8?q?[PHP=208.4]=20Update=20WeakReference::=5F?=
 =?UTF-8?q?=5FdebugInfo()=20changelog=E3=82=92=E5=8F=96=E3=82=8A=E8=BE=BC?=
 =?UTF-8?q?=E3=81=BF?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

https://github.com/php/doc-en/commit/7caf0c13762e7db3e7002b1286f23b65d940e2d0
---
 language/predefined/weakreference.xml | 26 +++++++++++++++++++++++++-
 1 file changed, 25 insertions(+), 1 deletion(-)

diff --git a/language/predefined/weakreference.xml b/language/predefined/weakreference.xml
index e406de5e35..ddd3d91ff5 100644
--- a/language/predefined/weakreference.xml
+++ b/language/predefined/weakreference.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: cd391e65a613a729f9bbded2b1249e2d7143400c Maintainer: mumumu Status: ready -->
+<!-- EN-Revision: 7caf0c13762e7db3e7002b1286f23b65d940e2d0 Maintainer: mumumu Status: ready -->
 <reference xml:id="class.weakreference" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
 
  <title>WeakReference クラス</title>
@@ -80,6 +80,30 @@ NULL
    </para>
   </section>
 
+  <section role="changelog">
+   &reftitle.changelog;
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>8.4.0</entry>
+       <entry>
+        <methodname>WeakReference::__debugInfo</methodname> の出力に、
+        参照されたオブジェクトを含むようになりました。また、参照が有効ではなくなっている場合は、
+        参照されたオブジェクトは <literal>NULL</literal> となります。
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </section>
+
  </partintro>
 
  &language.predefined.weakreference.construct;