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

querySelectorメソッドは、WebページなどのDOM（Document Object Model）構造の中から、指定したCSSセレクターに合致する最初の要素を検索し、取得するメソッドです。

このメソッドは、PHPのDOM拡張機能において、HTMLやXMLドキュメント内の個々の要素を表すDom\Elementクラスに属しています。ウェブページの構造をプログラムで操作する際に、特定の要素を見つけ出すために使用されます。

引数には、検索したい要素を指定するための文字列（CSSセレクター）を渡します。例えば、特定のIDを持つ要素を検索する場合は「#myId」、特定のクラスを持つ要素を検索する場合は「.myClass」、特定のタグ名の要素を検索する場合は「div」といった形式で指定します。複雑なセレクター（例: div.container > p）も利用可能です。

検索に成功した場合、合致した最初の要素を表すDom\Elementオブジェクトが返されます。もし、指定されたセレクターに合致する要素がドキュメント内に見つからなかった場合は、nullが返されます。このメソッドは、たとえ複数の要素がセレクターに合致しても、最初に見つかった1つだけを返す点に注意が必要です。

このメソッドを使用することで、Webページから特定のボタンや入力欄、表示領域などを効率的に見つけ出し、その内容を読み取ったり、属性を変更したり、イベントを操作したりするプログラミングが可能になります。WebスクレイピングやDOM操作を伴うWebアプリケーション開発において非常に重要な役割を果たします。

Copy
1<?php
2
3$dom = new Dom\Document();
4$dom->loadHTML('<div id="container"><p class="item">Example Text</p></div>');
5
6// Dom\DocumentからDom\Elementのインスタンスを取得
7$containerElement = $dom->getElementById('container');
8
9// Dom\Element::querySelector メソッドの構文
10if ($containerElement instanceof Dom\Element) {
11    $firstItem = $containerElement->querySelector('.item');
12}
13
14?>

string $selectors

• string $selectors: DOM要素を検索するためのCSSセレクタ文字列

?Dom\Element

DOMDocumentの要素の中から、指定されたCSSセレクタに一致する最初の要素、または見つからなかった場合はnullを返します。