PHPUnitでHTMLをDOMでパースしてテスト
PHPでなんらかのHTMLを出力するコードをテストする際に、これまでは正規表現とかでいい加減なチェックをしてたんですが、割と大きめなHTMLを出す際にいい加減不安なのでDOMを使ってチェックすることにしました。
当初はPHP本体の DOMDocument::loadHTML でやろうとしたんですが、HTML5
の <section> を使うと DOMDocument::loadHTML(): Tag section invalid in Entity, line: 1 と怒られてしまって断念。
その後いろいろ試した結果以下の2つのライブラリを使用すれば CSS セレクタでいい感じにチェックできました。
symfony/dom-crawlersymfony/css-selector
いつも思うんですが、Symfony 先輩さすがですね。
依存関係のインストール
まず、上の2つを composer でインストール。
$ composer require symfony/dom-crawler symfony/css-selector --dev
今回はテストで使うので --dev 付きで。
DOMを返すメソッドをテストケースに書く
まず、HTML を渡すと DOM を返してくれるメソッドを用意します。<html></html> とかで囲ってあげなくてもいいみたい。
<?php
class Sample_Test extends UnitTestCase
{
private function dom( $html )
{
$dom = new Symfony\Component\DomCrawler\Crawler();
$dom->addHTMLContent( $html, "UTF-8" );
return $dom;
}
}
テストを書く
次に実際のテストを書きます。test_html() というメソッドがそれ。
do_something()は何らかのHTMLを返す関数です。
<?php
class Sample_Test extends UnitTestCase
{
public function test_html()
{
$result = do_something();
$dom = $this->dom( $result );
$this->assertSame( 1, count( $dom->filter( '.col-3' ) ) );
$this->assertSame( 6, count( $dom->filter( 'section.item' ) ) );
}
private function dom( $html )
{
$dom = new Symfony\Component\DomCrawler\Crawler();
$dom->addHTMLContent( $html, "UTF-8" );
return $dom;
}
}
この例では、CSSセレクタを使用して、そのセレクタにマッチする要素が期待した数だけあるかをチェックしています。
$this->assertSame( 1, count( $dom->filter( '.col-3' ) ) );
$this->assertSame( 6, count( $dom->filter( 'section.item' ) ) );
ドキュメントは以下。
このテストでできないこと。
HTMLの構文チェックはできません。たとえば閉じタグがないタグを置いても頑張ってパースしてくれてしまいます。
そして <hoge> みたいに適当な要素をおいても同じく頑張ってくれてしまいます。
以下のようなメソッドで閉じタグ漏れぐらいはチェックできるかも。
private function assertMaybeValidHTML( $html )
{
$html = str_replace( 'section', 'div', $html );
$html = str_replace( 'aside', 'div', $html );
$dom = new DOMDocument();
$dom->loadHTML( '<html><body>' . $html . '</body></html>' );
}
Author And Source
この問題について(PHPUnitでHTMLをDOMでパースしてテスト), 我々は、より多くの情報をここで見つけました https://qiita.com/miya0001/items/178f31035f63bba63f67著者帰属：元の著者の情報は、元のURLに含まれています。著作権は原作者に属する。
Content is automatically searched and collected through network algorithms . If there is a violation . Please contact us . We will adjust (correct author information ,or delete content ) as soon as possible .