Last updated: Fri, 13 Nov 2009

DOMDocument::loadHTML

(PHP 5)

DOMDocument::loadHTML — 文字列から HTML を読み込む

説明

bool DOMDocument::loadHTML ( string $source )

この関数は、文字列 source に含まれる HTML をパースします。XML を読み込む場合とは異なり、妥当な HTML でなくても読み込むことができます。この関数をスタティックにコールすると、読み込んだ内容をもとに DOMDocument オブジェクトを作成します。読み込み前に DOMDocument のプロパティを設定する必要がない場合に、スタティックに実行することがあるでしょう。

パラメータ

source: HTML 文字列。

返り値

成功した場合に TRUE を、失敗した場合に FALSE を返します。静的にコールされた場合には DOMDocument を返し、 E_STRICT 警告を発生させます。

エラー / 例外

空の文字列を source に渡すと、警告が発生します。この警告は libxml が発するものではないので、libxml のエラー処理関数では処理できません。

例

例1 ドキュメントを作成する


<?php
$doc = new DOMDocument();
$doc->loadHTML("<html><body>Test<br></body></html>");
echo $doc->saveHTML();
?>

参考

DOMDocument::loadHTMLFile - ファイルから HTML を読み込む
DOMDocument::saveHTML - 内部のドキュメントを HTML 形式の文字列として出力する
DOMDocument::saveHTMLFile - 内部のドキュメントを HTML 形式でファイルに出力する

DOMDocument::loadHTMLFile

DOMDocument::load

Last updated: Fri, 13 Nov 2009

add a note User Contributed Notes
DOMDocument::loadHTML

piopier
15-Jun-2009 12:29


Here is a function I wrote to capitalize the previous remarks about charset problems (UTF-8...) when using loadHTML and then DOM functions.

It adds the charset meta tag just after <head> to improve automatic encoding detection, converts any specific character to an html entity, thus PHP DOM functions/attributes will return correct values.



<?php

mb_detect_order("ASCII,UTF-8,ISO-8859-1,windows-1252,iso-8859-15");

function loadNprepare($url,$encod='') {

        $content        = file_get_contents($url);

        if (!empty($content)) {

                if (empty($encod))

                        $encod  = mb_detect_encoding($content);

                $headpos        = mb_strpos($content,'<head>');

                if (FALSE=== $headpos)

                        $headpos= mb_strpos($content,'<HEAD>');

                if (FALSE!== $headpos) {

                        $headpos+=6;

                        $content = mb_substr($content,0,$headpos) . '<meta http-equiv="Content-Type" content="text/html; charset='.$encod.'">' .mb_substr($content,$headpos);

                }

                $content=mb_convert_encoding($content, 'HTML-ENTITIES', $encod);

        }

        $dom = new DomDocument;

        $res = $dom->loadHTML($content);

        if (!$res) return FALSE;

        return $dom;

}

?>



NB: it uses mb_strpos/mb_substr instead of mb_ereg_replace because that seemed more efficient with huge html pages.

Errol
12-Feb-2009 01:05


It should be noted that when any text is provided within the body tag


outside of a containing element, the DOMDocument will encapsulate that


text into a paragraph tag (<p>).





For example:


<?php


$doc = new DOMDocument();


$doc->loadHTML("<html><body>Test<br><div>Text</div></body></html>");


echo $doc->saveHTML();


?>





will yield:


<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"


"http://www.w3.org/TR/REC-html40/loose.dtd">


<html><body>


<p>Test<br></p>


<div>Text</div>


</body></html>





while:


<?php


$doc = new DOMDocument();


$doc->loadHTML(


    "<html><body><i>Test</i><br><div>Text</div></body></html>");


echo $doc->saveHTML();


?>





will yield:


<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"


"http://www.w3.org/TR/REC-html40/loose.dtd">


<html><body>


<i>Test</i><br><div>Text</div>


</body></html>

jamesedwardcooke+php at gmail dot com
20-Oct-2008 03:37


Using loadHTML() automagically sets the doctype property of your DOMDocument instance(to the doctype in the html, or defaults to 4.0 Transitional). If you set the doctype with DOMImplementation it will be overridden.



I assumed it was possible to set it and then load html with the doctype I defined(in order to decide the doctype at runtime), and ran into a huge headache trying to find out where my doctype was going. Hopefully this helps someone else.

onPHP5.com
19-Nov-2007 11:51


For more info on how loadHTML/loadHTMLFile handle encodings, please visit http://www.onphp5.com/article/57

xuanbn at yahoo dot com
04-Oct-2007 05:38


If you use loadHTML() to process utf HTML string (eg in Vietnamese), you may experience result in garbage text, while some files were OK. Even your HTML already have meta charset  like



  <meta http-equiv="content-type" content="text/html; charset=utf-8">



I have discovered that, to help loadHTML() process utf file correctly, the meta tag should come first, before any utf string appear. For example, this HTML file



<html>

 <head>

    <meta http-equiv="content-type" content="text/html; charset=utf-8">

    <title> Vietnamese - Tiếng Việt</title>

  </head>

<body></body>

</html>



will be OK with loadHTML() when <meta> tag appear <title> tag.



But the file below will not regcornize by loadHTML() because <title> tag contains utf string appear before <meta> tag.



<html>

 <head>

    <title> Vietnamese - Tiếng Việt</title>

    <meta http-equiv="content-type" content="text/html; charset=utf-8">

  </head>

<body></body>

</html>

Ard
18-Jun-2007 07:55


The comment from bigtree at DONTSPAM dot 29a dot nl

26-Apr-2005 11:15 was helpful.

In addition I noted that if your doctype declaration is not valid, DomDocument::loadHtml won't respect your charset=utf-8. It made me crazy. Beware!

hanhvansu at yahoo dot com
27-Apr-2007 12:50


When using loadHTML() to process UTF-8 pages, you may meet the problem that the output of dom functions are not like the input. For example, if you want to get "Cạnh tranh", you will receive "Cáº¡nh tranh".  I suggest we use mb_convert_encoding before load UTF-8 page :

<?php

    $pageDom = new DomDocument();    

    $searchPage = mb_convert_encoding($htmlUTF8Page, 'HTML-ENTITIES', "UTF-8"); 

    @$pageDom->loadHTML($htmlUTF8Page);



?>

romain dot lalaut at laposte dot net
16-Feb-2007 01:31


Note that the elements of such document will have no namespace even with <html xmlns="http://www.w3.org/1999/xhtml">

bigtree at DONTSPAM dot 29a dot nl
26-Apr-2005 06:15


Pay attention when loading html that has a different charset than iso-8859-1. Since this method does not actively try to figure out what the html you are trying to load is encoded in (like most browsers do), you have to specify it in the html head. If, for instance, your html is in utf-8, make sure you have a meta tag in the html's head section:



<head>

<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>

</head>



If you do not specify the charset like this, all high-ascii bytes will be html-encoded. It is not enough to set the dom document you are loading the html in to UTF-8.

add a note

DOMDocument::loadHTMLFile

DOMDocument::load

Last updated: Fri, 13 Nov 2009