Skip to content

Commit 1a832b8

Browse files
committed
xml_set_関連のものを追記
1 parent 9f5e471 commit 1a832b8

File tree

1 file changed

+35
-2
lines changed

1 file changed

+35
-2
lines changed

language-snippets.ent

Lines changed: 35 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5170,14 +5170,32 @@ xmlns="http://docbook.org/ns/docbook"><simpara>この関数は、PECL uopz 5.0.0
51705170
</varlistentry>'>
51715171

51725172
<!ENTITY xml.handler.description '<para xmlns="http://docbook.org/ns/docbook">
5173-
&null; や空文字列を渡すと、ハンドラはデフォルトの状態にリセットされます。
5173+
&null; が渡されると、ハンドラはデフォルトの状態にリセットされます。
5174+
<warning>
5175+
<simpara>
5176+
空文字列を渡すことでもハンドラはリセットされますが、これは PHP 8.4.0 以降非推奨となっています。
5177+
</simpara>
5178+
</warning>
51745179
</para>
51755180
<para xmlns="http://docbook.org/ns/docbook">
51765181
<parameter>handler</parameter> が <type>callable</type> の場合、その callable がハンドラとして設定されます。
51775182
</para>
51785183
<para xmlns="http://docbook.org/ns/docbook">
51795184
<parameter>handler</parameter> が文字列の場合、<function>xml_set_object</function> で設定されたオブジェクトのメソッド名になります。
5180-
</para>'>
5185+
<warning>
5186+
<simpara>
5187+
PHP 8.4.0 以降、非推奨となっています。
5188+
</simpara>
5189+
</warning>
5190+
</para>
5191+
<warning xmlns="http://docbook.org/ns/docbook">
5192+
<simpara>
5193+
PHP 8.4.0 以降では、実際に呼び出されるときではなく、ハンドラを設定する際に callable であるかがチェックされます。
5194+
これにより、コールバックとしてメソッド文字列を設定する前に、 <function>xml_set_object</function> を呼び出す必要があります。
5195+
しかし、この動作も PHP 8.4.0 以降非推奨となっているため、メソッドには適切な <type>callable</type> を使用することが推奨されます。
5196+
</simpara>
5197+
</warning>
5198+
'>
51815199

51825200
<!ENTITY xml.handler.parser.param '<varlistentry xmlns="http://docbook.org/ns/docbook">
51835201
<term><parameter>parser</parameter></term>
@@ -5188,6 +5206,21 @@ xmlns="http://docbook.org/ns/docbook"><simpara>この関数は、PECL uopz 5.0.0
51885206
</listitem>
51895207
</varlistentry>'>
51905208

5209+
<!ENTITY xml.changelog.handler-param '<row xmlns="http://docbook.org/ns/docbook">
5210+
<entry>8.4.0</entry>
5211+
<entry>
5212+
非 <type>callable</type> な <type>string</type> を <parameter>handler</parameter> に渡すことは、現在非推奨となっています。
5213+
メソッドには適切な callable を使用するか、ハンドラをリセットする場合は &null; を使用してください。
5214+
</entry>
5215+
</row>
5216+
<row xmlns="http://docbook.org/ns/docbook">
5217+
<entry>8.4.0</entry>
5218+
<entry>
5219+
<parameter>handler</parameter> が <type>callable</type> として有効であるかどうかは、
5220+
呼び出し時ではなく、ハンドラーを設定する際にチェックされるようになりました。
5221+
</entry>
5222+
</row>'>
5223+
51915224
<!ENTITY xml.changelog.parser-param '<row xmlns="http://docbook.org/ns/docbook">
51925225
<entry>8.0.0</entry>
51935226
<entry>

0 commit comments

Comments
 (0)