【PHP8.x】DOMText::isSupported()メソッドの使い方

Copy
1<?php
2
3/**
4 * DOMText::isSupported メソッドの動作を示すサンプルコード。
5 *
6 * このメソッドは、指定された機能 (feature) とバージョン (version) が
7 * DOM実装でサポートされているかをチェックするために使用されます。
8 * しかし、PHPのDOM拡張における isSupported メソッド（DOMNodeクラスで定義され、
9 * DOMTextが継承）は、DOM Level 2 Coreの仕様に基づいていますが、
10 * 実際の実装では常に false を返します。
11 *
12 * @param string $feature チェックするDOM機能の名前（例: "XML", "HTML", "Core"）
13 * @param string $version チェックするDOM Levelのバージョン（例: "1.0", "2.0", "3.0"）
14 * @return bool 指定された機能とバージョンがサポートされているかどうか。
15 *              PHPのDOMText::isSupportedは常に false を返します。
16 */
17function demonstrateDomTextIsSupported(string $feature, string $version): bool
18{
19    // DOMDocumentインスタンスを作成
20    $dom = new DOMDocument();
21
22    // DOMTextインスタンスを作成し、DOMDocumentに追加
23    // isSupportedメソッドはDOMNodeクラスで定義され、DOMTextがそれを継承しているため、
24    // DOMTextインスタンスから呼び出すことができます。
25    $textNode = $dom->createTextNode("Hello, PHP!");
26    $dom->appendChild($textNode);
27
28    // DOMText::isSupported メソッドを呼び出し、サポート状況をチェック
29    // PHPの実装では、このメソッドはどんな入力に対しても常に false を返します。
30    $isSupported = $textNode->isSupported($feature, $version);
31
32    echo "DOMText::isSupported for feature '{$feature}' and version '{$version}': "
33        . ($isSupported ? 'true' : 'false') . "\n";
34
35    return $isSupported;
36}
37
38// サンプルとして異なる機能とバージョンでメソッドを実行します。
39// 実行結果は常に false となります。
40echo "--- DOMText::isSupported のデモンストレーション --- \n";
41demonstrateDomTextIsSupported("XML", "1.0");
42demonstrateDomTextIsSupported("HTML", "2.0");
43demonstrateDomTextIsSupported("Core", "3.0");
44echo "-------------------------------------------------- \n";
45
46?>

PHPのDOMText::isSupportedメソッドは、特定のDOM機能とバージョンが、DOMTextノードを含む現在のDOM実装でサポートされているかを確認するために使用されます。このメソッドはDOMNodeクラスで定義されており、DOMTextはその機能を継承しています。

引数$featureにはチェックしたいDOM機能の名前を文字列で指定し（例えば "XML" や "Core"）、引数$versionにはその機能のDOMレベルのバージョンを文字列で渡します（例えば "1.0" や "3.0"）。戻り値は真偽値（bool）で、サポートされていればtrue、そうでなければfalseが返されることが期待されます。

しかし、PHPのDOM拡張におけるisSupportedメソッドは、DOM Level 2 Coreの仕様に基づきますが、実際の実装ではどんな引数に対しても常にfalseを返します。このため、現在のPHP環境では、このメソッドを呼び出しても、サポート状況を正確に判断することはできません。サンプルコードでは、異なる機能とバージョンを試していますが、実行結果は常にfalseとなることが確認できます。

Copy
1<?php
2
3/**
4 * DOMText::isSupported メソッドの使用例を示します。
5 * 指定されたDOM機能とバージョンが現在のDOM実装でサポートされているかを確認します。
6 *
7 * この関数は、PHPのDOM拡張機能が、特定のDOM標準バージョンで定義されている機能を
8 * どれだけサポートしているかを示すために使用できます。
9 * これは、間接的に「PHPがサポートするバージョン」の一部として、
10 * DOMの特定の機能セットが利用可能かどうかを判断するのに役立ちます。
11 *
12 * @param string $feature 確認するDOM機能名 (例: 'XML', 'HTML', 'Core')
13 * @param string $version 確認するDOM機能のバージョン (例: '1.0', '2.0', '3.0')
14 * @return void
15 */
16function checkDomFeatureSupport(string $feature, string $version): void
17{
18    // DOMText::isSupported は DOMText オブジェクトのメソッドなので、
19    // まず DOMDocument オブジェクトと DOMText ノードを作成する必要があります。
20    $dom = new DOMDocument();
21
22    // ルート要素を作成し、DOMドキュメントに追加します。
23    $element = $dom->createElement('rootElement');
24    $dom->appendChild($element);
25
26    // DOMText ノードを作成し、作成した要素に追加します。
27    // このテキストノードのインスタンスから isSupported を呼び出します。
28    $textNode = $dom->createTextNode('Hello, World!');
29    $element->appendChild($textNode);
30
31    echo "Checking support for DOM feature '{$feature}' (version '{$version}'):\n";
32
33    // DOMText::isSupported メソッドを呼び出して、指定された機能が
34    // 現在のDOM実装でサポートされているかを確認します。
35    if ($textNode->isSupported($feature, $version)) {
36        echo "  -> This feature and version are SUPPORTED.\n";
37    } else {
38        echo "  -> This feature and version are NOT SUPPORTED.\n";
39    }
40}
41
42// 以下は、DOMText::isSupported メソッドの具体的な使用例です。
43// これらの例は、DOM標準の特定のバージョン（例: XML 1.0, Core 2.0）が
44// PHPのDOM拡張でサポートされているかどうかを調べます。
45// これは、「php supported versions」というキーワードが示すように、
46// PHPのDOM拡張がどのDOM標準バージョンに準拠しているかを知る手がかりになります。
47
48// 例1: XML 1.0 のサポートを確認
49// ほとんどのDOM実装でサポートされています。
50checkDomFeatureSupport('XML', '1.0');
51
52// 例2: XML 2.0 のサポートを確認
53// DOM Level 2 の機能として提供されます。
54checkDomFeatureSupport('XML', '2.0');
55
56// 例3: Core 2.0 のサポートを確認
57// DOM Level 2 の主要な機能の一部です。
58checkDomFeatureSupport('Core', '2.0');
59
60// 例4: HTML 1.0 のサポートを確認
61// DOM Level 2 HTML モジュールの機能として提供されます。
62checkDomFeatureSupport('HTML', '1.0');
63
64// 例5: 存在しないであろう機能のサポートを確認
65// 通常、false を返します。
66checkDomFeatureSupport('NonExistentFeature', '1.0');
67

DOMText::isSupportedメソッドは、PHPのDOM拡張機能において、特定のDOM機能とバージョンがサポートされているかを確認します。

このメソッドはDOMTextクラスに属するため、利用する際はまずDOMDocumentオブジェクトと、そこに追加されるDOMTextノードを作成する必要があります。引数$featureには調べたいDOM機能名（例: 'XML', 'Core'）を、$versionにはその機能のバージョン（例: '1.0', '2.0'）を文字列で指定します。戻り値はbool型で、指定された機能がサポートされていればtrue、そうでなければfalseを返します。

サンプルコードでは、テキストノードを作成し、そのインスタンスからisSupportedを呼び出して、XML 1.0やCore 2.0のようなDOM機能のサポート状況を調べています。これは、PHPのDOM拡張がどのDOM標準バージョンに準拠しているか、どの機能セットが利用可能かを知る手がかりとなります。実行結果は「SUPPORTED」または「NOT SUPPORTED」と表示されます。