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

createDocumentTypeメソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 2025年09月11日更新日: 2025年10月28日

基本的な使い方

createDocumentTypeメソッドは、PHPのDOM拡張機能において、ドキュメントタイプ定義（DOCTYPE）ノードを表すDOMDocumentTypeオブジェクトを生成するメソッドです。このメソッドは、XMLやHTMLなどのドキュメントが、どのような構造規則に従うべきかを宣言するDOCTYPE宣言をプログラム的に作成する際に使用されます。

特に、HTML5以前のHTMLドキュメントや、外部のDTD（Document Type Definition）に基づいて厳密な構造を持つXMLドキュメントを構築する際に役立ちます。このメソッドは三つの引数を受け取ります。最初の$qualifiedNameは、ドキュメントのルート要素の名前（例えばHTMLドキュメントの場合はhtml）を指定します。二番目の$publicIdは、外部DTDを参照する際に使用されるパブリック識別子を指定し、三番目の$systemIdは、DTDファイルの場所を示すシステム識別子（通常はURL）を指定します。

このメソッドは、指定された情報を持つ新しいDOMDocumentTypeオブジェクトを返します。生成されたDOMDocumentTypeオブジェクトは、その後、DOMDocumentオブジェクトのルートに追加することで、ドキュメントの冒頭にDOCTYPE宣言として組み込まれます。これにより、作成されるドキュメントが特定のDTDに準拠していることを明示的に示すことができます。DOMImplementationクラスは、このようにドキュメントの基盤となる部分を構築するための、実装固有の機能を提供しています。

構文(syntax)


1<?php
2$domImplementation = new DOMImplementation();
3$documentType = $domImplementation->createDocumentType(
4    'qualifiedName',
5    'publicId',
6    'systemId'
7);
8?>

引数(parameters)

string $qualifiedName, string $publicId = '', string $systemId = ''

string $qualifiedName: 新しく作成するDOCTYPE宣言の修飾名（例: "html", "svg"）
string $publicId = '': DOCTYPE宣言の公開識別子。省略可能です。
string $systemId = '': DOCTYPE宣言のシステム識別子。省略可能です。

戻り値(return)

DOMDocumentType

new DOMDocumentTypeを生成して返します。これは、指定された名前空間URI、ローカル名、および公開/システム識別子を持つ新しいDOCTYPE宣言を表現します。

サンプルコード

PHP DOMでDOCTYPEと要素を生成する


1<?php
2
3/**
4 * DOMImplementation::createDocumentType メソッドと DOMDocument::createElement メソッドを使用して、
5 * HTML5 ドキュメントの基本構造を生成するサンプルコードです。
6 *
7 * このコードは、DOCTYPE 宣言を持つHTMLドキュメントをゼロから構築し、
8 * その中に基本的なHTML要素（html, head, body, title, h1, p）を追加する方法を示します。
9 */
10
11// DOMImplementation オブジェクトを生成します。
12// これは、DOCTYPE ノードなど、特定の種類のDOMノードを作成するためのファクトリとして機能します。
13$domImplementation = new DOMImplementation();
14
15// createDocumentType メソッドを使用して、HTML5 の DOCTYPE ノードを生成します。
16// 第一引数 'html' は、ドキュメントタイプ名を指定します。
17// HTML5 では通常、第二引数 (publicId) と第三引数 (systemId) は空文字列を使用します。
18$docType = $domImplementation->createDocumentType('html', '', '');
19
20// 新しい DOMDocument オブジェクトを生成します。
21// このオブジェクトは、XML/HTML ドキュメント全体を表します。
22$dom = new DOMDocument('1.0', 'UTF-8');
23
24// ドキュメントタイプノードを DOMDocument に追加します。
25// これにより、<!DOCTYPE html> 宣言がドキュメントの先頭に配置されます。
26$dom->appendChild($docType);
27
28// ドキュメントのルート要素として 'html' 要素を作成し、ドキュメントに追加します。
29// createElement は、指定された名前の要素ノードを生成します。
30$htmlElement = $dom->createElement('html');
31$dom->appendChild($htmlElement);
32
33// 'head' 要素を作成し、'html' 要素の子として追加します。
34$headElement = $dom->createElement('head');
35$htmlElement->appendChild($headElement);
36
37// 'body' 要素を作成し、'html' 要素の子として追加します。
38$bodyElement = $dom->createElement('body');
39$htmlElement->appendChild($bodyElement);
40
41// 'title' 要素を作成し、テキストコンテンツを設定した後、'head' 要素の子として追加します。
42// createElement の第二引数で直接テキストコンテンツを指定することもできます。
43$titleElement = $dom->createElement('title', 'DOM サンプルページ');
44$headElement->appendChild($titleElement);
45
46// 'h1' 要素を作成し、テキストコンテンツを設定した後、'body' 要素の子として追加します。
47$h1Element = $dom->createElement('h1', 'PHP DOM で生成されたページ');
48$bodyElement->appendChild($h1Element);
49
50// 'p' 要素を作成し、テキストコンテンツを設定した後、'body' 要素の子として追加します。
51$pElement = $dom->createElement('p', 'これは DOMImplementation::createDocumentType と DOMDocument::createElement を使ったサンプルです。');
52$bodyElement->appendChild($pElement);
53
54// 出力時にHTMLが整形されるように設定します。
55$dom->formatOutput = true;
56
57// 生成されたDOMツリーをHTML文字列として出力します。
58echo $dom->saveHTML();

このサンプルコードは、PHPのDOM機能を活用し、HTML5ドキュメントの基本的な構造をプログラムで生成する方法を示しています。

まず、DOMImplementationクラスのインスタンスを生成します。このクラスは、特にDOCTYPE宣言ノードのような特定のDOMノードを作成する際に使用され、createDocumentTypeメソッドを提供します。createDocumentTypeメソッドは、第一引数にドキュメントタイプ名（例: 'html'）を、第二引数と第三引数にはそれぞれ公開識別子とシステム識別子を受け取りますが、HTML5の場合はこれらを空文字列として呼び出すことが一般的です。このメソッドは、作成されたDOMDocumentTypeオブジェクトを返します。

次に、新しいDOMDocumentオブジェクトを作成し、先に生成したDOMDocumentTypeノードをappendChildメソッドで追加します。これにより、HTMLドキュメントの先頭に<!DOCTYPE html>宣言が配置されます。

その後、DOMDocumentオブジェクトのcreateElementメソッドを使って、html、head、body、titleなどの各HTML要素ノードを生成していきます。createElementメソッドは、第一引数に作成する要素の名前を指定し、オプションで第二引数にその要素のテキストコンテンツを直接設定することも可能です。このメソッドは、生成されたDOMElementオブジェクトを返します。これらの要素ノードをappendChildメソッドで適切な親子関係に配置していくことで、完全なHTMLツリーを構築します。

最後に、$dom->formatOutput = true;を設定して整形出力を有効にし、$dom->saveHTML();メソッドで構築されたDOMツリー全体をHTML文字列として出力しています。これにより、プログラムで動的にHTMLドキュメントが作成され、ブラウザで表示可能な形式で得られます。

PHPのDOM操作では、ノードの追加順序が非常に重要です。<!DOCTYPE html>はドキュメントの最初に、その次に<html>要素をappendChildで追加するなど、HTML/XMLの階層構造を意識して正しく構築してください。createDocumentType('html', '', '')はHTML5の簡潔なDOCTYPE宣言で、Public IDとSystem IDは空です。createElementでテキストコンテンツを設定する際、外部からの入力値はクロスサイトスクリプティング（XSS）を防ぐため、必ずサニタイズしてください。$dom->formatOutput = true;は開発時の整形に便利ですが、本番環境でのパフォーマンスを考慮し、不要な場合はオフにすることも検討しましょう。

PHP DOM: createDocumentTypeとcreateElementでHTML生成


1<?php
2
3/**
4 * DOMDocumentTypeとDOM要素を作成し、完全なHTMLドキュメントを構築するサンプル
5 *
6 * このコードは、DOMImplementation::createDocumentType メソッドを使用してDOCTYPE宣言を作成し、
7 * DOMDocument::createElement メソッドを使用してHTML要素を作成する方法を示します。
8 * システムエンジニアを目指す初心者がDOM操作の基本を理解するのに役立ちます。
9 */
10
11// 1. DOM実装のインスタンスを作成します。
12//    DOMImplementationは、DOMDocumentやDOMDocumentTypeのようなオブジェクトを作成するためのインターフェースを提供します。
13$domImplementation = new DOMImplementation();
14
15// 2. createDocumentTypeメソッドを使用して、HTML5のDOCTYPE宣言を表すDOMDocumentTypeオブジェクトを作成します。
16//    - 第1引数 'html': ドキュメントタイプの名前（HTML5では 'html'）
17//    - 第2引数 '': publicId（HTML5では通常空文字列）
18//    - 第3引数 '': systemId（HTML5では通常空文字列）
19$doctype = $domImplementation->createDocumentType('html', '', '');
20
21// 3. createDocumentメソッドを使用して、DOCTYPEとルート要素を含む新しいDOMDocumentオブジェクトを作成します。
22//    - 第1引数 null: 名前空間URI（HTML5では通常null）
23//    - 第2引数 'html': ドキュメントのルート要素名
24//    - 第3引数 $doctype: 先ほど作成したDOMDocumentTypeオブジェクト
25$dom = $domImplementation->createDocument(null, 'html', $doctype);
26
27// 4. 生成されるXML/HTMLを整形して読みやすくするための設定です。
28$dom->formatOutput = true;
29
30// 5. キーワード 'createElement' に関連する操作として、HTML要素を作成しドキュメントに追加します。
31//    まず、<head>要素を作成し、ルート要素である<html>の子として追加します。
32$head = $dom->createElement('head');
33$dom->documentElement->appendChild($head);
34
35// 6. <title>要素を作成し、そのテキストコンテンツを設定して、<head>要素の子として追加します。
36$title = $dom->createElement('title', 'PHP DOM Example Page');
37$head->appendChild($title);
38
39// 7. <body>要素を作成し、ルート要素である<html>の子として追加します。
40$body = $dom->createElement('body');
41$dom->documentElement->appendChild($body);
42
43// 8. <h1>要素を作成し、そのテキストコンテンツを設定して、<body>要素の子として追加します。
44$h1 = $dom->createElement('h1', 'Welcome to DOM Manipulation with PHP');
45$body->appendChild($h1);
46
47// 9. <p>要素を作成し、そのテキストコンテンツを設定して、<body>要素の子として追加します。
48$p = $dom->createElement('p', 'This example demonstrates how to use createDocumentType and createElement.');
49$body->appendChild($p);
50
51// 10. 構築したDOMDocumentオブジェクトをHTML文字列として出力します。
52//     saveHTML() は、HTMLドキュメントを適切にシリアライズします。
53echo $dom->saveHTML();
54
55?>

このPHPサンプルコードは、システムエンジニアを目指す初心者の方向けに、DOM（Document Object Model）操作の基本的な流れを解説しています。特に、DOMImplementation::createDocumentTypeメソッドとDOMDocument::createElementメソッドの具体的な使用方法を示しています。

まず、DOMImplementation::createDocumentTypeメソッドは、HTMLドキュメントの先頭に記述されるDOCTYPE宣言（例えば<!DOCTYPE html>)を表すDOMDocumentTypeオブジェクトを作成します。このメソッドには、ドキュメントのタイプ名（HTML5の場合はhtml）や、公開識別子、システム識別子を引数として渡します。戻り値として、指定された情報を持つDOMDocumentTypeオブジェクトが得られます。サンプルでは、このオブジェクトをDOMImplementation::createDocumentメソッドに渡すことで、DOCTYPEと<html>ルート要素を含む新しいDOMDocumentオブジェクトを生成しています。

次に、DOMDocument::createElementメソッドは、<html>、<head>、<body>、<h1>のようなHTML要素をプログラム上で作成するために使用されます。このメソッドの第1引数には作成したい要素名を指定し、オプションで第2引数にその要素のテキストコンテンツも直接設定できます。作成された要素はDOMElementオブジェクトとして返され、appendChildメソッドなどを使ってドキュメントツリー内の適切な位置に追加していきます。サンプルコードでは、このcreateElementを使って様々なHTML要素を生成し、それらを順次ドキュメントに追加していくことで、完全なHTML構造を構築しています。

最終的に、構築されたDOMDocumentオブジェクトに対してsaveHTML()メソッドを呼び出すことで、作成したDOCTYPEとHTML要素から構成される、整形されたHTMLドキュメントの文字列が出力されます。これにより、PHPを使って動的にHTML構造を作り出す基本的なプロセスを理解することができます。

このサンプルコードは、DOMImplementation::createDocumentType メソッドでHTML5のDOCTYPEを生成し、DOMDocument::createElement メソッドでHTML要素を構築する基本的な流れを示しています。createDocumentType の引数はHTML5の場合、通常 'html', '', '' と指定しますが、XMLなどの異なるドキュメントタイプでは適切な引数を設定してください。createElement で要素を作成しただけではドキュメントに追加されず、必ず appendChild メソッドを使って親要素の子として追加することで、正しいドキュメントツリーが構築されます。DOMDocument::formatOutput = true は、生成されるHTMLやXMLの出力を見やすく整形するための設定であり、本番環境などではパフォーマンスを考慮して使用しないこともあります。HTMLとして出力する場合は saveHTML() を、XMLとして出力する場合は saveXML() を適切に使い分けてください。