# DOMDocument::getElementsByTagName

(PHP 5, PHP 7, PHP 8)

DOMDocument::getElementsByTagName — Cherche tous les éléments qui ont le nom de la balise locale donné

### Description

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

Cette fonction retourne une instance de la classe DOMNodeList contenant tous les éléments qui ont un nom de balise donné.

### Liste de paramètres

`qualifiedName`

  Le nom local (sans espace de nommage) de la balise à chercher. La valeur spéciale `*` correspond à toutes les balises.

### Valeurs de retour

Un nouvel objet DOMNodeList contenant tous les éléments correspondants.

### Exemples

Exemple #1 Exemple de base

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

L'exemple ci-dessus va afficher :

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

### Voir aussi

- DOMDocument::getElementsByTagNameNS() - Recherche tous les éléments avec un nom de balise donné dans un espace de noms spécifié