Skip to content

PHP 8.4: Document DOM deprecations #254

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.

Sign up for GitHub

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

Merged
merged 2 commits into from
Feb 2, 2025
Merged

PHP 8.4: Document DOM deprecations #254

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
b8a5ac8
DOMの非推奨部分を翻訳
Ippey Jan 19, 2025
5232ea2
.を。に
Ippey Jan 26, 2025
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
View file
Open in desktop
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
View file
Open in desktop
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
46 changes: 34 additions & 12 deletions reference/dom/domentity.xml
View file
Open in desktop
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 @@ -123,37 +123,59 @@
<term><varname>actualEncoding</varname></term>
<listitem>
<para>
外部でパースされたエンティティの場合は、このエンティティの
パース時に使用されたエンコーディングを指定する属性。
内部サブセットからのエンティティであったり未知のエンティティで
あった場合は &null;
<emphasis>PHP8.4.0より非推奨</emphasis>.
Copy link
Contributor

@takaram takaram Jan 26, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

.→。に統一するのがよさそうです。
（encoding, versionの説明も同様）

Copy link
Contributor Author

@Ippey Ippey Jan 26, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@takaram ありがとうございます。修正しました！

常に &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