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

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

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

基本的な使い方

querySelectorAllメソッドは、Dom\Documentクラスに属するメソッドで、指定されたCSSセレクタに一致する要素をすべて取得し、Dom\NodeListオブジェクトとして返します。このメソッドは、ドキュメント全体から条件に合致する要素を効率的に検索するために使用されます。

具体的には、引数としてCSSセレクタ文字列を受け取り、そのセレクタに合致する要素をドキュメントツリー内で探索します。例えば、querySelectorAll('div.example') と記述すると、class属性が "example" であるすべてのdiv要素が検索されます。

返り値として得られるDom\NodeListオブジェクトは、取得された要素のリストを保持しており、配列のように扱うことができます。ただし、NodeListは通常の配列とは異なり、ライブコレクションであるため、ドキュメントの内容が変更されるとNodeListの内容も動的に更新されるという特徴があります。

querySelectorAllメソッドは、JavaScriptのquerySelectorとquerySelectorAllメソッドと同様の機能を提供しますが、PHPのDOM拡張機能の一部として動作します。そのため、PHPでサーバーサイドのDOM操作を行う際に非常に役立ちます。例えば、HTMLドキュメントをロードし、特定の条件を満たす要素を抽出し、その要素の内容を処理したり、属性を変更したりするなどの操作が可能です。

このメソッドを使用することで、複雑なHTML構造から必要な情報を効率的に抽出し、プログラム内で利用することができます。DOMDocumentクラスの他のメソッドと組み合わせることで、HTMLドキュメントの解析、編集、生成など、様々な処理を柔軟に行うことが可能になります。

構文(syntax)


1<?php
2
3$dom = new DomDocument();
4$dom->loadHTML('<html><body><div class="foo">test</div><div class="bar">test2</div></body></html>');
5
6$elements = $dom->querySelectorAll('div');
7
8foreach ($elements as $element) {
9  echo $element->nodeValue . PHP_EOL;
10}
11
12?>

引数(parameters)

string $selectors

string $selectors: 検索したい要素を指定するCSSセレクタ文字列

戻り値(return)

Dom\NodeList

Dom\NodeList オブジェクトを返します。このオブジェクトは、指定されたCSSセレクターに一致するすべてのDOMノードのコレクションです。