【PHP8.x】createFromStringメソッドの使い方

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

作成日: 2025年09月11日更新日: 2025年11月07日

基本的な使い方

createFromStringメソッドは、DOMDocumentオブジェクトとしてHTMLまたはXML文字列から新しいドキュメントを作成するメソッドです。Dom\HTMLDocumentクラスに属し、HTMLDocumentオブジェクトにHTMLコンテンツを読み込むために使用されます。

具体的には、このメソッドは引数としてHTMLまたはXMLの文字列を受け取り、その文字列を解析してDOMDocumentオブジェクトを生成します。生成されたDOMDocumentオブジェクトは、元のHTMLまたはXML文字列の構造を表現するDOMツリーとしてアクセスできます。

このメソッドは、既存のDOMDocumentオブジェクトにHTMLコンテンツを追加したり、HTMLコンテンツから新しいDOMDocumentオブジェクトを作成したりする際に役立ちます。例えば、Webスクレイピングで取得したHTMLコンテンツを解析して、必要な情報を抽出したり、HTMLコンテンツをプログラムで生成してDOMDocumentオブジェクトとして操作したりする場合などに利用できます。

createFromStringメソッドは、HTMLまたはXMLの構文エラーをある程度許容します。しかし、不正な構文を含む文字列を解析した場合、予期しない結果になる可能性があるため、注意が必要です。

このメソッドは、loadHTMLメソッドやloadXMLメソッドと似た機能を提供しますが、createFromStringメソッドは文字列を直接引数として受け取る点が異なります。これにより、ファイルから読み込む手間を省き、メモリ上に存在する文字列から直接DOMDocumentオブジェクトを生成することができます。

createFromStringメソッドは、PHP 8以降で使用可能です。以前のバージョンでは、loadHTMLメソッドやloadXMLメソッドを使用して同様の処理を行う必要があります。

構文(syntax)


1public Dom\Element|false Dom\HTMLDocument::createFromString(string $source): Dom\Element|false

引数(parameters)

string $source, int $options = 0, ?string $overrideEncoding = null

string $source: 解析するHTMLソースコードを含む文字列
int $options = 0: 解析オプションを指定する整数。デフォルトは0（オプションなし）。
?string $overrideEncoding = null: HTMLソースのエンコーディングを上書きする場合に指定する文字列。指定しない場合はnull。

戻り値(return)

Dom\HTMLDocument

このメソッドは、HTML文字列を解析して作成された新しいHTMLDocumentオブジェクトを返します。

サンプルコード

PHP HTMLDocument createFromStringする


1<?php
2
3// HTML文字列から新しいDom\HTMLDocumentオブジェクトを作成するサンプル
4function createHTMLDocumentFromString(string $htmlString): Dom\HTMLDocument
5{
6    // Dom\HTMLDocumentオブジェクトを新規作成
7    $dom = new Dom\HTMLDocument();
8
9    // HTML文字列からDom\HTMLDocumentを生成
10    $dom->createFromString($htmlString);
11
12    // 生成されたDom\HTMLDocumentオブジェクトを返す
13    return $dom;
14}
15
16// HTML文字列の例
17$html = <<<HTML
18<!DOCTYPE html>
19<html>
20<head>
21    <title>サンプルページ</title>
22</head>
23<body>
24    <h1>こんにちは、世界！</h1>
25    <p>これはサンプルテキストです。</p>
26</body>
27</html>
28HTML;
29
30// createHTMLDocumentFromString関数を使用してDom\HTMLDocumentオブジェクトを作成
31$document = createHTMLDocumentFromString($html);
32
33// 作成されたドキュメントの内容を出力 (デバッグ用)
34// echo $document->saveHTML();

PHP 8のDom\HTMLDocumentクラスにおけるcreateFromStringメソッドは、HTML文字列から新しいDom\HTMLDocumentオブジェクトを生成するために使用します。このメソッドは、HTML文字列を解析し、その内容を元にDOM（Document Object Model）ツリーを構築します。

createFromStringメソッドは、string $source、int $options = 0、?string $overrideEncoding = nullという3つの引数を持ちます。$sourceは必須の引数で、解析するHTML文字列を指定します。$optionsはオプションの引数で、解析時の挙動を制御するためのフラグを指定します。デフォルト値は0で、特別なオプションは適用されません。$overrideEncodingもオプションの引数で、HTML文字列のエンコーディングを上書きするために使用します。nullが指定された場合は、HTML文字列内のエンコーディング宣言が使用されます。

サンプルコードでは、createHTMLDocumentFromString関数を定義し、HTML文字列を受け取ってcreateFromStringメソッドを使ってDom\HTMLDocumentオブジェクトを生成しています。まず、new Dom\HTMLDocument()で新しいDom\HTMLDocumentオブジェクトを作成します。次に、$dom->createFromString($htmlString)で、渡されたHTML文字列からDOMを生成します。最後に、生成されたDom\HTMLDocumentオブジェクトを返します。

作成されたDom\HTMLDocumentオブジェクトは、saveHTML()メソッドなどを使用して、HTML文字列として出力したり、DOM操作を行うために使用できます。サンプルコード内のコメントアウトされたecho $document->saveHTML();は、生成されたHTMLドキュメントの内容を文字列として出力する例を示しています。これはデバッグや確認のために利用できます。

Dom\HTMLDocument::createFromStringメソッドは、HTML文字列を解析してDom\HTMLDocumentオブジェクトを生成します。引数$sourceにはHTML文字列を渡します。$optionsはオプションのフラグで、特殊な解析方法を指定できます（通常は0で問題ありません）。$overrideEncodingはエンコーディングの上書きに使用しますが、通常はnullで自動検出に任せるのが安全です。

HTML文字列に誤りがあると、エラーが発生するか、期待通りにパースされない可能性があります。特に、タグが正しく閉じられていない、ネスト構造が間違っているなどの基本的なミスに注意してください。また、外部からの入力に基づいてHTML文字列を生成する場合は、クロスサイトスクリプティング（XSS）などのセキュリティリスクに十分注意し、エスケープ処理を適切に行ってください。saveHTML()メソッドは、生成されたHTMLを文字列として出力するので、デバッグに役立ちます。