指定したローカルタグ名に対応するすべての要素を検索する

# DOMDocument::getElementsByTagName

(PHP 5, PHP 7, PHP 8)

DOMDocument::getElementsByTagName — 指定したローカルタグ名に対応するすべての要素を検索する

### 説明

public function DOMDocument::getElementsByTagName(string `$qualifiedName`): DOMNodeList

この関数は、指定したローカルタグ名のすべての要素を含む DOMNodeList クラスの新しいインスタンスを返します。

### パラメータ

`qualifiedName`

  タグのローカル名 (名前空間を除いたもの) に一致する名前。`*` はすべてのタグに一致します。

### 戻り値

一致するすべての要素を含む、新しい DOMNodeList オブジェクトを返します。

### 例

例1 基本的な使用例

    <?php
    $xml = <<< XML
    <?xml version="1.0" encoding="utf-8"?>
    <books>
     <book>Patterns of Enterprise Application Architecture</book>
     <book>Design Patterns: Elements of Reusable Software Design</book>
     <book>Clean Code</book>
    </books>
    XML;

    $dom = new DOMDocument;
    $dom->loadXML($xml);
    $books = $dom->getElementsByTagName('book');
    foreach ($books as $book) {
        echo $book->nodeValue, PHP_EOL;
    }
    ?>

上の例の出力は以下となります。

    Patterns of Enterprise Application Architecture
    Design Patterns: Elements of Reusable Software Design
    Clean Code

### 参考

- DOMDocument::getElementsByTagNameNS() - 指定した名前空間で、タグ名に対応するすべての要素を検索する

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open