# DOMDocument::getElementsByTagName

(PHP 5, PHP 7, PHP 8)

DOMDocument::getElementsByTagName — Searches for all elements with given local tag name

### Beschreibung

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

This function returns a new instance of class DOMNodeList containing all the elements with a given local tag name.

### Parameter-Liste

`qualifiedName`

  The local name (without namespace) of the tag to match on. The special value `*` matches all tags.

### Rückgabewerte

A new DOMNodeList object containing all the matched elements.

### Beispiele

Beispiel #1 Basic Usage Example

`<?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;
}
?>`

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

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

### Siehe auch

- DOMDocument::getElementsByTagNameNS() - Searches for all elements with given tag name in specified namespace

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