Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

PHP 8.4: Document DOM deprecations #254

Merged
merged 2 commits into from
Feb 2, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion reference/dom/constants.xml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: f44eff3695dbe664b4acf5d32e1643fe6448b51c Maintainer: takagi Status: ready -->
<!-- EN-Revision: 38d0723a6e865c163527b252afbca7fc91ac473d Maintainer: takagi Status: ready -->
<chapter xml:id="dom.constants" xmlns="http://docbook.org/ns/docbook">
&reftitle.constants;
&extension.constants;
Expand Down Expand Up @@ -261,6 +261,8 @@
<entry>0</entry>
<entry>
DOM の仕様にないエラーコードです。PHP のエラーを意味します。
今後使用されないため、非推奨となりました。
PHP8.4.0より前では、メモリ不足を示すために一貫性がなく使用されてきました。
</entry>
</row>
<row xml:id="constant.dom-index-size-err">
Expand Down
13 changes: 10 additions & 3 deletions reference/dom/domdocument.xml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 0217f85ed26dc9511fb6b44e87d82f4b77adafa1 Maintainer: takagi Status: ready -->
<!-- EN-Revision: 38d0723a6e865c163527b252afbca7fc91ac473d Maintainer: takagi Status: ready -->
<!-- Credits: mumumu -->
<reference xml:id="class.domdocument" 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>DOMDocument クラス</title>
Expand Down Expand Up @@ -188,7 +188,7 @@
<term><varname>actualEncoding</varname></term>
<listitem>
<para>
<emphasis>非推奨</emphasis>。ドキュメントの実際のエンコーディング。
<emphasis>PHP8.4.0より非推奨</emphasis>。ドキュメントの実際のエンコーディング。
読み込み専用で、
<varname linkend="domdocument.props.encoding">encoding</varname>
と同等の内容です。
Expand All @@ -205,7 +205,7 @@
<term><varname>config</varname></term>
<listitem>
<para>
<emphasis>非推奨</emphasis>。
<emphasis>PHP8.4.0より非推奨</emphasis>。
<function>DOMDocument::normalizeDocument</function>
を実行する際に使用する設定。
</para>
Expand Down Expand Up @@ -407,6 +407,13 @@
</row>
</thead>
<tbody>
<row>
<entry>8.4.0</entry>
<entry>
<varname>actualEncoding</varname> と
<varname>config</varname> は正式に非推奨となりました。
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
Expand Down
48 changes: 35 additions & 13 deletions reference/dom/domentity.xml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 14767af0f05dffa6fdb9b49e1a1f4e9ca7022a60 Maintainer: takagi Status: ready -->
<!-- EN-Revision: 38d0723a6e865c163527b252afbca7fc91ac473d Maintainer: takagi Status: ready -->
<!-- Credits: mumumu -->
<reference xml:id="class.domentity" 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>DOMEntity クラス</title>
Expand Down Expand Up @@ -115,45 +115,67 @@
<listitem>
<para>
パースされていないエンティティの場合はそのエンティティの名前、
パース済みのエンティティの場合は &null;
パース済みのエンティティの場合は &null;
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="domentity.props.actualencoding">
<term><varname>actualEncoding</varname></term>
<listitem>
<para>
外部でパースされたエンティティの場合は、このエンティティの
パース時に使用されたエンコーディングを指定する属性。
内部サブセットからのエンティティであったり未知のエンティティで
あった場合は &null;
<emphasis>PHP8.4.0より非推奨</emphasis>。
常に &null; と等しくなります。
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="domentity.props.encoding">
<term><varname>encoding</varname></term>
<listitem>
<para>
外部でパースされたエンティティの場合は、テキスト宣言の一部として
このエンティティのエンコーディングを指定する属性。それ以外の場合は
&null;
<emphasis>PHP8.4.0より非推奨</emphasis>。
常に &null; と等しくなります。
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="domentity.props.version">
<term><varname>version</varname></term>
<listitem>
<para>
外部でパースされたエンティティの場合は、テキスト宣言の一部として
このエンティティのバージョン番号を指定する属性。それ以外の場合は
&null;
<emphasis>PHP8.4.0より非推奨</emphasis>。
常に &null; と等しくなります。
</para>
</listitem>
</varlistentry>
</variablelist>
</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>
<varname>actualEncoding</varname>,
<varname>encoding</varname>, と
<varname>version</varname> は常に &null; と等しくなるため、
正式に非推奨となりました。
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</section>

<!-- {{{ See also -->
<!--
<section role="seealso">
Expand Down